Skip to main content

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

{
  "companyOverview": "ClickFlow is an AI-powered SEO platform...",
  "tone": "Professional but approachable",
  "targetAudience": "SEO professionals and content teams",
  "competitiveContext": "Competes with Surfer SEO, Clearscope..."
}

Usage

Call platform.get_brand_voice with no parameters.
Returns {"error": "No brand voice configured for this organization"} if not set up yet. Configure it in the ClickFlow dashboard.

platform.analyze_keyword

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

Parameters

NameTypeRequiredDefaultDescription
keywordstringYesThe keyword to analyze
locationstringNo"United States"Target location
languagestringNo"en"Language code

Response

{
  "keyword_difficulty": 65,
  "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

{
  "keyword": "best project management tools",
  "location": "United States"
}

platform.list_target_keywords

List tracked target keywords with SEO metrics.

Parameters

NameTypeRequiredDefaultDescription
limitintegerNo500Maximum keywords to return

Response

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

Usage

{ "limit": 100 }
If you have many keywords, the response may return {"error": "Too many keywords. Try a smaller limit."}. Reduce the limit parameter.

platform.list_competitors

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

Parameters

None.

Response

{
  "competitors": [
    {
      "domain": "competitor.com",
      "name": "Competitor Inc",
      "avgPosition": 12.5,
      "intersections": 45,
      "tracked": true
    }
  ],
  "count": 1
}

Usage

Call platform.list_competitors with no parameters.