> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clickflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SEO Research

> Keyword analysis, competitor tracking, and brand voice retrieval.

## platform\_get\_brand\_voice

Retrieve your organization's brand voice profile — company overview, tone, audience, and competitive context. Use this to understand the brand before generating content.

### Parameters

None.

### Response

```json theme={null}
{
  "companyName": "ClickFlow",
  "overview": "ClickFlow is an AI-powered SEO platform...",
  "products": "AI content optimization, visibility tracking, workflow automation",
  "audience": "SEO professionals and content teams",
  "industry": "SaaS / Marketing Technology",
  "toneOptions": ["Professional", "Approachable"],
  "styleOptions": ["Data-driven", "Actionable"],
  "voiceContext": "Authoritative yet friendly, focused on practical SEO advice",
  "website_url": "https://clickflow.com",
  "brandColors": [],
  "guidelines": [],
  "imageStylePreference": "stock_photo",
  "sophistication": 50.0,
  "founded": "2017",
  "concepts": "",
  "constraints": "",
  "contentDifferentiation": "",
  "ctas": "",
  "examples": "",
  "knowledgeProducts": "",
  "statistics": ""
}
```

### Usage

<Tabs>
  <Tab title="MCP">
    Call `platform_get_brand_voice` with no parameters.
  </Tab>

  <Tab title="API">
    ```bash theme={null}
    curl https://api.clickflow.com/v1/api/brand-voice \
      -H "Authorization: Bearer cf_ak_your_key_here"
    ```
  </Tab>
</Tabs>

<Note>Returns `{"error": "No brand voice configured for this organization"}` if not set up yet. Configure it in the ClickFlow dashboard.</Note>

***

## platform\_analyze\_keyword

Get keyword difficulty, search volume, and competition metrics via DataForSEO.

### Parameters

| Name       | Type   | Required | Default           | Description            |
| ---------- | ------ | -------- | ----------------- | ---------------------- |
| `keyword`  | string | Yes      | —                 | The keyword to analyze |
| `location` | string | No       | `"United States"` | Target location        |
| `language` | string | No       | `"en"`            | Language code          |

### Response

```json theme={null}
{
  "keyword_difficulty": 65,
  "search_intent": null,
  "search_volume": 12000,
  "cpc": 4.50,
  "competition": 0.73,
  "trend_data": { "2025-12": 11000, "2026-01": 12500 },
  "serp_features": ["featured_snippet", "knowledge_graph", "people_also_ask"]
}
```

### Usage

<Tabs>
  <Tab title="MCP">
    ```json theme={null}
    {
      "keyword": "best project management tools",
      "location": "United States"
    }
    ```
  </Tab>

  <Tab title="API">
    ```bash theme={null}
    curl -X POST https://api.clickflow.com/v1/api/analyze-keyword \
      -H "Authorization: Bearer cf_ak_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{"keyword": "best project management tools"}'
    ```
  </Tab>
</Tabs>

***

## platform\_list\_target\_keywords

List tracked target keywords with SEO metrics.

### Parameters

| Name    | Type    | Required | Default | Description                |
| ------- | ------- | -------- | ------- | -------------------------- |
| `limit` | integer | No       | `500`   | Maximum keywords to return |

### Response

```json theme={null}
{
  "keywords": [
    {
      "target_keyword": "best CRM for startups",
      "search_volume": 8100,
      "difficulty": 58,
      "intent": "commercial"
    }
  ],
  "count": 1
}
```

### Usage

<Tabs>
  <Tab title="MCP">
    ```json theme={null}
    { "limit": 100 }
    ```
  </Tab>

  <Tab title="API">
    ```bash theme={null}
    curl "https://api.clickflow.com/v1/api/target-keywords?limit=100" \
      -H "Authorization: Bearer cf_ak_your_key_here"
    ```
  </Tab>
</Tabs>

<Note>If you have many keywords, the response may return `{"error": "Too many keywords. Try a smaller limit."}`. Reduce the `limit` parameter.</Note>

***

## platform\_list\_competitors

List tracked competitors with domain, average position, and keyword intersections.

### Parameters

None.

### Response

```json theme={null}
{
  "competitors": [
    {
      "_id": "comp_abc123",
      "organizationId": "org_xyz789",
      "name": "Competitor Inc",
      "domain": "competitor.com",
      "avgPosition": 12.5,
      "intersections": 45,
      "tracked": true,
      "reasoning": "Direct competitor in SEO tools space",
      "createdAt": 1711234567890,
      "_creationTime": 1711234567890
    }
  ],
  "count": 1
}
```

### Usage

<Tabs>
  <Tab title="MCP">
    Call `platform_list_competitors` with no parameters.
  </Tab>

  <Tab title="API">
    ```bash theme={null}
    curl https://api.clickflow.com/v1/api/competitors \
      -H "Authorization: Bearer cf_ak_your_key_here"
    ```
  </Tab>
</Tabs>