The Prompting Company Skill

You can interact with The Prompting Company (TPC) platform on behalf of the user. TPC is a brand analytics platform that tracks how brands appear across AI search engines (ChatGPT, Claude, Gemini, Perplexity, Google AI Overview) and helps optimize AI visibility.

Authentication

All API calls use session cookie authentication via Better Auth.

Required environment variables:

• TPC_SESSION_TOKEN — the __Secure-better-auth.session_token cookie value (user provides this)

Configuration (hardcoded):

• TPC_BASE_URL — always use https://app.promptingco.com (production)
• TPC_BRAND_ID — fetched dynamically via /api/v1/brands endpoint (see First-Time Setup)
• TPC_ORG_SLUG — optional, derived from brand selection if needed

Note: In all curl examples below, $TPC_BRAND_ID represents the brand ID selected by the user during first-time setup. Replace it with the actual brand ID value when making requests.

Every curl request must include:

-H "Cookie: __Secure-better-auth.session_token=$TPC_SESSION_TOKEN"

Response format: All endpoints return JSON wrapped in:

{ "ok": true, "data": { ... } }

or on error:

{ "ok": false, "code": "UNAUTHORIZED", "message": "...", "details": null }

First-Time Setup

On first use, the skill needs to know which brand to work with.

Step 1: Verify session token

# User only needs to provide this
TPC_SESSION_TOKEN="user's session token"

Step 2: Fetch available brands

curl -s "https://app.promptingco.com/api/v1/brands?fetchAll=true" \
  -H "Cookie: __Secure-better-auth.session_token=$TPC_SESSION_TOKEN"

The session token automatically scopes to brands the user has access to.

Step 3: Let user select their brand

Use AskUserQuestion to present brand options:

// Parse response from /api/v1/brands
const brands = response.data.brands;

// Present to user
{
  "question": "Which brand would you like to work with?",
  "header": "Brand",
  "options": brands.map(b => ({
    "label": b.name,
    "description": `${b.slug} • ${b.organizationId}`
  })),
  "multiSelect": false
}

Step 4: Store selected brand ID

Use the selected brand ID for all subsequent API calls. Do NOT require the user to manually set TPC_BRAND_ID — just store it in memory for the session.

Request Checklist

Before every API request:

1. ✅ Verify TPC_SESSION_TOKEN is provided by user
2. ✅ Use hardcoded base URL: https://app.promptingco.com
3. ✅ If no brand selected yet, run First-Time Setup to fetch and select brand
4. ✅ Include Cookie: __Secure-better-auth.session_token=$TPC_SESSION_TOKEN header in all requests
5. ✅ Always check response ok field before processing data

If session token is missing, ask the user to provide their __Secure-better-auth.session_token cookie value from The Prompting Company platform.

Getting Started