Skip to main content
AI agent tools run synchronously and return results directly. They are slower than data queries (15-60 seconds) because they invoke LLM-powered agents.

​
agents.optimize_blog_title

Optimize a blog post title for SEO and click-through rate.

​
Parameters

NameTypeRequiredDefaultDescription
target_keywordstringYes—The keyword to optimize for
current_titlestringYes—The existing title
contentstringNo""Page content for better context
business_contextstringNo""Additional business context
user_promptstringNo""Custom instructions for the optimizer

​
Response

{
  "success": true,
  "error": null,
  "output": {
    "title": "Best CRM for Startups: 7 Tools Compared (2026)",
    "alternatives": [
      "Top CRM Tools for Startups — Honest Comparison",
      "Which CRM Is Best for Your Startup? We Tested 7"
    ],
    "quality_metrics": { "keyword_placement": "front", "character_count": 52 }
  }
}

​
Usage

{
  "target_keyword": "best CRM for startups",
  "current_title": "CRM Tools Review"
}
Takes 20-30 seconds.

​
agents.optimize_meta_description

Optimize a meta description for SEO and click-through rate. Returns a 150-160 character description.

​
Parameters

NameTypeRequiredDefaultDescription
target_keywordstringYes—The keyword to optimize for
current_descriptionstringYes—The existing meta description
contentstringNo""Page content for context
business_contextstringNo""Additional business context

​
Response

{
  "success": true,
  "error": null,
  "output": {
    "description": "Compare the 7 best CRM tools for startups in 2026. We tested pricing, features, and ease of use to help you pick the right one.",
    "alternatives": ["..."]
  }
}
Takes 15-25 seconds.

​
agents.generate_faqs

Generate FAQ question-answer pairs from content. Returns 7 structured pairs optimized for SEO.

​
Parameters

NameTypeRequiredDefaultDescription
contentstringYes—The full text content
titlestringNo""Page title for context

​
Response

{
  "success": true,
  "error": null,
  "output": {
    "faqs": [
      {
        "question": "What is the best CRM for startups?",
        "answer": "The best CRM for startups depends on your team size and budget..."
      }
    ]
  }
}
Takes 20-30 seconds.

​
agents.research_company

Research a company from its website URL. Returns a summary of who they are, their products, target customers, and digital marketing approach.

​
Parameters

NameTypeRequiredDescription
urlstringYesThe company’s website URL

​
Response

{
  "success": true,
  "error": null,
  "output": {
    "company_name": "Acme Corp",
    "overview": "Acme Corp is a B2B SaaS company...",
    "products": ["Product A", "Product B"],
    "target_customers": "Mid-market B2B companies",
    "marketing_approach": "Content-led growth with strong SEO presence"
  }
}
Takes 20-40 seconds.

​
agents.generate_image

Generate an image from a text prompt using AI.

​
Parameters

NameTypeRequiredDefaultDescription
promptstringYes—Text description of the image
stylestringNo""stock_photo, watercolor, illustration, sketch
sizestringNo"1024x1024"Image dimensions
qualitystringNo"standard"Image quality level

​
Response

{
  "success": true,
  "error": null,
  "output": {
    "url": "https://storage.googleapis.com/clickflow-images/generated/abc123.png"
  }
}
Takes 20-30 seconds.

​
agents.analyze_competitors

Analyze top-ranking pages for a keyword. Returns competitive landscape including content gaps, ranking factors, and opportunities.

​
Parameters

NameTypeRequiredDefaultDescription
keywordstringYes—The keyword to analyze
analysis_depthstringNo"basic"basic or comprehensive

​
Response

{
  "success": true,
  "error": null,
  "output": {
    "top_pages": [...],
    "content_gaps": [...],
    "ranking_factors": [...],
    "opportunities": [...]
  }
}
Takes 30-60 seconds. comprehensive depth takes longer.

​
agents.analyze_search_intent

Analyze the search intent behind a keyword. Returns intent classification, user questions from Google PAA and social sources, and content angle recommendations.

​
Parameters

NameTypeRequiredDescription
keywordstringYesThe keyword to analyze

​
Response

{
  "success": true,
  "error": null,
  "output": {
    "intent": "commercial",
    "questions": [
      "What is the best CRM for small businesses?",
      "How much does a CRM cost?"
    ],
    "content_angles": [
      "Comparison-style content performs best",
      "Include pricing tables"
    ]
  }
}
Takes 20-40 seconds.

​
Error handling

All agent tools return a consistent shape. On failure: 
{
  "success": false,
  "error": "Description of what went wrong",
  "output": null
}
Agents never return fallback data — they fail explicitly with a clear error message.