Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.topify.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
What the agent is and when to use it

Topify.ai’s AI agent is a chat-based interface to Topify’s research, content, and optimization tools. Instead of clicking through dashboards, you describe what you need in natural language and the agent picks the right skill — a specialized capability like keyword research, site profiling, or article writing — and runs it for you. Use the agent whenever you want to combine multiple capabilities (research → strategy → content) in one conversation, or whenever a task crosses several data sources at once.

​
How to interact with the agent

The agent understands natural language. Describe your goal, and it determines which skill to use and what information it needs. Example interactions:
  • “Research keywords for my website example.com”
  • “Analyze the SEO health of example.com”
  • “Write an article about cloud hosting best practices”
  • “Optimize this content for AI search visibility” (with content provided)
  • “Find content gaps between my site and these two competitors”
If the agent needs more information to complete a task, it will ask you follow-up questions before proceeding.

​
Multi-step workflows

For complex requests, the agent breaks the work into subtasks and executes them in sequence. For example, asking “Research keywords and create a content strategy for my website” triggers:
  1. Site profiling to understand your brand
  2. Keyword research using the profile
  3. Content strategy built on the keyword findings
Each step builds on the output of the previous one, and all results are available for reference in follow-up conversations.

​
Agent capabilities

The agent’s skills span four areas: research, content, site analysis, and GEO optimization. Each skill is backed by specialized data sources and can be combined into multi-step workflows.

​
Research

Discover high-value keywords by analyzing your site, competitors, and search data.What it does:
  • Generates seed keywords from your site profile and brand context
  • Expands seeds using search volume, difficulty, and competition data from Semrush
  • Supplements with competitor keyword data to find opportunities they rank for
  • Deduplicates and clusters keywords by topic
  • Scores each keyword for business relevance to your brand
Output: A structured keyword list with search volume, keyword difficulty, search intent, and business relevance scores.Example: “Research keywords for my e-commerce store that sells running shoes”
Identify your top competitors and analyze their keyword strategies.What it does:
  • Discovers competitors based on keyword overlap and market positioning
  • Analyzes competitor keyword portfolios and rankings
  • Compares content strategies across competitors
  • Provides strategic recommendations for differentiation
Output: Competitor profiles with keyword overlap analysis, content strengths, and actionable recommendations.Example: “Who are my top competitors and what keywords are they ranking for?”

​
Content

Generate a strategic content plan tailored to your brand and audience.What it does:
  • Analyzes your existing content landscape
  • Maps keywords to content topics and formats
  • Prioritizes topics by business impact and competition level
  • Creates a content calendar with publishing cadence recommendations
Output: A prioritized content plan with topic clusters, suggested formats, and a publishing timeline.Example: “Create a 3-month content strategy for my SaaS blog”
Create a full SEO-optimized article with structured content.What it does:
  • Researches the topic using web search and your provided references
  • Generates a detailed outline with section structure
  • Writes the full article with keyword integration
  • Applies GEO optimization techniques for AI search visibility
  • Generates SEO metadata (title, description, slug)
Output: A complete article in Markdown with SEO metadata and keyword targeting.Example: “Write an article about the best practices for cloud migration”
Write and publish an article directly to your CMS.What it does:
  • Writes the article (same process as above)
  • Formats content for your CMS platform
  • Uploads featured images
  • Applies categories, tags, and SEO metadata
  • Publishes or saves as draft based on your preference
Supported platforms: WordPress, Shopify, FramerExample: “Write and publish an article about email marketing trends to my WordPress blog”

​
Site analysis

Analyze what a website is about and how it positions itself.What it does:
  • Crawls your website to understand its structure and content
  • Identifies your business model, products, and services
  • Maps your target audience and content themes
  • Assesses brand positioning and messaging
Output: A comprehensive site profile covering business model, industry, offerings, audience, and content themes.Example: “Analyze my website example.com and tell me what you find”
Run a comprehensive audit covering multiple dimensions of search performance.What it does:
  • Audits technical SEO health (if site access is available)
  • Pulls search performance data from Google Search Console
  • Checks keyword rankings and SERP data
  • Benchmarks against competitors
Data sources: Google Search Console, SemrushOutput: A multi-dimensional SEO audit with scores, identified issues, and prioritized recommendations.Example: “Run a full SEO analysis on my website”
SEO analysis is most effective when you’ve connected your Google Search Console account. See Integrations for setup instructions.
Analyze your Google Search Console data for trends and insights.What it does:
  • Pulls click, impression, CTR, and position data from GSC
  • Identifies top-performing queries and pages
  • Surfaces declining or rising trends
  • Highlights opportunities for quick wins
Output: Performance summary with trend analysis and actionable insights.Example: “Show me my search performance trends for the last 3 months”

​
GEO optimization

Compare your content against competitors to find what you’re missing.What it does:
  • Crawls and analyzes content from 2—5 competitor sites
  • Compares topic coverage, content depth, and formats
  • Identifies AI citation gaps using GEO methodology
  • Categorizes opportunities by effort and impact:
    • Quick wins — low effort, high impact topics you can address immediately
    • Strategic builds — medium effort topics that strengthen your content foundation
    • Long-term investments — high effort topics that establish authority over time
Output: A gap analysis report with prioritized content opportunities and competitive comparisons.Example: “Find content gaps between my site and competitor1.com and competitor2.com”
Rewrites existing content to maximize AI search visibility, applying the eight Princeton GEO techniques (citations, statistics, quotations, authoritative tone, etc.) most relevant to your industry.Output: Optimized content with tracked changes and an explanation of each applied technique.Example: “Optimize this blog post for AI search visibility”
See GEO methodology for the full technique table, measured visibility lifts, and per-industry recommendations.

​
Approval workflows

For certain tasks, the agent pauses to get your confirmation before proceeding. For example:
  • Competitor confirmation — after discovering competitors during site profiling, the agent presents the list for your review before saving
  • Publishing — before publishing to your CMS, the agent shows the article for your approval

​
Memory across sessions

The agent remembers findings from previous interactions within your project. For example:
  • Site profiles are reused when writing articles so the agent understands your brand context
  • Keyword research results are available for content strategy and article writing
  • Competitor data is retained for gap analysis
This means follow-up tasks build on previous work instead of starting from scratch.

​
Data sources and integrations

The agent connects to external services to power its analysis:
Data sourceUsed for
SemrushKeyword volume, difficulty, and competitor keyword data
Google Search ConsoleSearch clicks, impressions, CTR, and position data
Web scraperCrawling and extracting content from websites
Google Search Console requires OAuth2 authentication. Set it up in Integrations to get the most out of the agent’s analysis capabilities.

​
CMS publishing

The agent can publish articles directly to your website through supported CMS platforms:
Connects via the WordPress REST API. Supports:
  • Post creation with categories and tags
  • Featured image uploads
  • SEO metadata (compatible with Yoast and RankMath)
  • Draft or publish status
Setup: provide your WordPress site URL, username, and an application password (not your login password).
Connects via the Shopify GraphQL Admin API. Supports:
  • Blog article creation
  • Tags and status management
  • Blog selection (if you have multiple blogs)
Setup: provide your store URL, admin API access token, and blog ID.
Connects via the Framer CMS API. Supports:
  • Item creation in CMS collections
  • Automatic field mapping (title, body, excerpt, date, author)
Setup: provide your project URL, API key, and target collection ID.

​
FAQ

​
Will the agent publish to my CMS without asking me?

No. Publishing is gated behind an explicit approval step — the agent shows you the article, the destination CMS, and any tags/categories before pushing anything live. You can approve, edit, or reject. The same applies to other potentially-destructive actions (saving newly discovered competitors, applying GEO rewrites to existing pages).

​
What if I haven’t connected Google Search Console yet?

Most agent skills work without GSC — keyword research, content strategy, content generation, and GEO optimization all run on Topify’s own data and external research providers. The skills that benefit from GSC will tell you upfront and either ask you to connect it (instructions in Integrations) or fall back to a less-detailed analysis.