prompting-co

# 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:
```json
{ "ok": true, "data": { ... } }
```
or on error:
```json
{ "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
```bash
# User only needs to provide this
TPC_SESSION_TOKEN="user's session token"
```

### Step 2: Fetch available brands
```bash
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:

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

// Present to user
{
  "question": "Which brand woul...