# RankX AI documentation

> Product documentation for RankX AI. Every page below is also available
> as clean Markdown by appending `.md` to its URL, or by sending
> `Accept: text/markdown`.

- [RankX AI documentation](https://rankxai.com/docs): How RankX AI measures whether AI assistants name your brand, what every number means, and how to drive the whole platform from an AI assistant over MCP.
- Getting started: From knowing nothing to reading your first visibility numbers correctly.
  - [What RankX AI is](https://rankxai.com/docs/getting-started/what-is-rankx-ai): RankX AI measures whether AI assistants and Google name your brand when buyers ask, and turns the gaps into a prioritised fix list.
  - [Choosing your track](https://rankxai.com/docs/getting-started/choosing-your-track): RankX AI ships as a Direct track for one business and an Agency track for firms serving clients. Which to pick, and what changes if you pick wrong.
  - [Quickstart](https://rankxai.com/docs/getting-started/quickstart): Sign up, add your first Website, complete the six onboarding steps, and read your first AI visibility numbers. What happens at each step, and when.
  - [Onboarding, step by step](https://rankxai.com/docs/getting-started/onboarding): The six onboarding steps in RankX AI, what each one asks for, why the order is enforced, and what completing it starts.
  - [Your first week](https://rankxai.com/docs/getting-started/your-first-week): What appears in RankX AI on day one, day two and day seven, which screens are legitimately empty at each point, and why.
  - [Troubleshooting setup](https://rankxai.com/docs/getting-started/troubleshooting-setup): The symptoms people hit in their first days on RankX AI, what causes each one, and the fix. Starts with the trial that never started.
- Concepts: How RankX AI measures, what every number means, and the rules it refuses to break.
  - [How RankX AI measures visibility](https://rankxai.com/docs/concepts/how-rankx-ai-measures-visibility): The method behind every AI visibility number. What a check is, how often it runs, what is recorded, and the four things RankX AI refuses to infer.
  - [Metrics defined](https://rankxai.com/docs/concepts/metrics): Every number RankX AI shows, what its denominator is, and what it does not mean. Includes the metrics RankX AI deliberately does not report.
  - [Null is not zero](https://rankxai.com/docs/concepts/null-is-not-zero): RankX AI never reports an absence of measurement as a zero. Where each blank comes from, what it means, and how to read a screen that has them.
  - [Citations, two kinds](https://rankxai.com/docs/concepts/citations-two-kinds): AI Answer Citations and AI Overview Citations are different data from different engines. Which is which, where each lives, and how to use them.
  - [Credits and metering](https://rankxai.com/docs/concepts/credits-and-metering): One wallet per account, reserved before the work and released if it fails. What is charged, what is not, and the four refusals with four different remedies.
  - [Check cadence](https://rankxai.com/docs/concepts/check-cadence): How often RankX AI checks things, the two floors that apply, why the trial floor is seven days, and how cadence decides most of your credit spend.
  - [Glossary](https://rankxai.com/docs/concepts/glossary): Where terms are defined. The general AI search vocabulary lives in the RankX AI glossary; the terms specific to this product are defined here.
  - [Prompts and topic clusters](https://rankxai.com/docs/concepts/prompts-and-topic-clusters): The two objects that decide what RankX AI measures. How a prompt differs from a keyword, what a cluster joins together, and how to structure both.
  - [Websites, workspaces and accounts](https://rankxai.com/docs/concepts/websites-workspaces-and-organisations): RankX AI's object model in one page. What a Website is, what a Client Workspace is, what belongs to which, and the vocabulary used throughout these docs.

- **Measurement**
- AI Visibility: How your brand appears in AI assistant answers, and whether assistants can read your site at all.
  - [AI Visibility](https://rankxai.com/docs/ai-visibility): How RankX AI measures whether the five tracked AI assistants name your brand, and what each screen in the AI Visibility section is for.
  - [AI Prompts](https://rankxai.com/docs/ai-visibility/ai-prompts): The panel of questions RankX AI asks the assistants. Writing good ones, the three statuses, the per-plan cap, and why the prompt list is your credit bill.
  - [AI Chat Feed](https://rankxai.com/docs/ai-visibility/ai-chat-feed): The raw answers the assistants gave to your tracked prompts. The most useful screen in RankX AI, and the first one to read when a number surprises you.
  - [AI Answer Citations](https://rankxai.com/docs/ai-visibility/ai-answer-citations): The domains and pages AI assistants cited when answering your tracked prompts. What the list is good for, and why it is not AI Overview Citations.
  - [Tracked platforms](https://rankxai.com/docs/ai-visibility/tracked-platforms): The five AI assistants RankX AI tracks, what each is good for, and why Google AI Overviews is deliberately not one of them.
  - [AI Readiness](https://rankxai.com/docs/ai-visibility/ai-readiness): Whether AI assistants can reach, read and understand your site. Five scored categories, the checks RankX AI actually runs, and why a score can be withheld.
- Google Results: Tracked positions in ordinary Google results, and what Google's AI Overviews say about you.
  - [Google Results](https://rankxai.com/docs/google-results): Your position in ordinary Google results and what Google's AI Overviews say about you, measured by RankX AI's own checks rather than reported by Google.
  - [Rank tracking](https://rankxai.com/docs/google-results/rank-tracking): Tracking Google positions in RankX AI. The three position states, per-keyword settings, cadence and cost, and why untracking is reversible.
  - [AI Overviews](https://rankxai.com/docs/google-results/ai-overviews): How often Google shows an AI Overview for your tracked keywords, whether your brand is in it, and the three verdict states that must not be merged.
  - [AI Overview Citations](https://rankxai.com/docs/google-results/ai-overview-citations): The domains and pages Google's AI Overviews cited for your tracked keywords, ranked by how often. What it is good for, and what it is not.
- AI Shopping: Whether your products are recommended when a shopper asks an AI assistant.
  - [AI Shopping](https://rankxai.com/docs/ai-shopping): Whether your products are recommended when a shopper asks an AI assistant. Two surfaces, product-level rather than brand-level, with honest denominators.
  - [Shopping surfaces](https://rankxai.com/docs/ai-shopping/shopping-surfaces): The two AI shopping surfaces RankX AI observes, how they differ in what they expose, and the one difference that changes how every ads figure must be read.
  - [Products and the catalogue](https://rankxai.com/docs/ai-shopping/product-catalogue): How RankX AI matches shown product cards against your catalogue, why an incomplete catalogue reads as a loss, and what the Products screen tells you.
  - [Merchants](https://rankxai.com/docs/ai-shopping/merchants): The merchants whose products were recommended instead of yours in AI shopping answers, and why an incomplete catalogue inflates the list.
  - [Ads](https://rankxai.com/docs/ai-shopping/ads): Where advertising is observable in AI shopping answers and where it is not. One surface has no sponsored flag, so its zero means unknown.
- Traffic: Search Console, Analytics and index coverage, and what a missing figure means.
  - [Traffic](https://rankxai.com/docs/traffic): What Google reports about your site through Search Console and Analytics, how it differs from RankX AI's own measurements, and why a figure can be refused.
  - [Search Console](https://rankxai.com/docs/traffic/search-console): Clicks, impressions, CTR and position for your site, the four views RankX AI builds on them, and the provisional days that are never a decline.
  - [Google Analytics](https://rankxai.com/docs/traffic/google-analytics): Sessions, page views and landing pages from Analytics, the one live call in RankX AI, and the user figure that is not a count of unique visitors.
  - [Indexing](https://rankxai.com/docs/traffic/indexing): Which of your pages Google has indexed and why the rest are not. The screen that finds pages invisible everywhere else, because they earn no clicks to appear in.
  - [Why my traffic data is missing](https://rankxai.com/docs/traffic/why-my-traffic-data-is-missing): The four states a Google connection can be in, only one of which returns figures, plus the two to three day publishing delay that is not a drop.

- **Action**
- Website Audit: Crawling your site for technical problems, what each check means, and why a check may not have run.
  - [Website Audit](https://rankxai.com/docs/website-audit): RankX AI's technical crawl of your site. What it checks, how the score is weighted, and the rule that a check which did not run is never shown as passing.
  - [Running an audit](https://rankxai.com/docs/website-audit/running-an-audit): Starting a Website Audit in RankX AI, the modes available, how long it takes, and how to read the report when it finishes.
  - [Page selection and cost](https://rankxai.com/docs/website-audit/page-selection-and-cost): Which pages a Website Audit crawls, how the page count changes what it costs, and why a report on forty pages is a report on forty pages.
  - [What "a check did not run" means](https://rankxai.com/docs/website-audit/what-a-check-did-not-run-means): Three audit paths, and not every check can be produced by every one. Why RankX AI reports "not assessed" rather than a green tick, and what to do about it.
  - [Issue reference](https://rankxai.com/docs/website-audit/issue-reference): Every check the RankX AI Website Audit runs, with its severity, its weight, what it means and which audit paths can produce a verdict for it.
- Research & Content: Keyword research, topic clusters, briefs, article generation and publishing.
  - [Keyword research](https://rankxai.com/docs/research-and-content/keyword-research): Discovering keywords in RankX AI, what each figure means, how the cache makes repeats free, and how discovery feeds rank tracking and topic clusters.
  - [Topic clusters](https://rankxai.com/docs/research-and-content/topic-clusters): The single structure that keywords, tracked prompts and content all hang from in RankX AI. What a good cluster looks like, and why it is worth getting roughly right.
  - [Content briefs](https://rankxai.com/docs/research-and-content/content-briefs): Turning a keyword into a researched brief in RankX AI. What a brief contains, why the research step is free, and what approving one means.
  - [Generating articles](https://rankxai.com/docs/research-and-content/generating-articles): Generating a draft from a researched brief in RankX AI. What it produces, why it never publishes, and the pre-spend checks that stop you paying for nothing.
  - [Content quality scores](https://rankxai.com/docs/research-and-content/content-quality-scores): The two scores RankX AI puts on a generated article. What each gate checks, why they are pass or fail rather than weighted, and what a null score means.
  - [Campaigns](https://rankxai.com/docs/research-and-content/campaigns): Authority Campaigns group a canonical article and its channel variants around one subject. The three types, the journey a campaign follows, and when to use one.
  - [Publishing to WordPress](https://rankxai.com/docs/research-and-content/publishing-to-wordpress): Taking a RankX AI draft to a live WordPress site. What is verified, what is refused, and the two mistakes that cost the most.
- Tasks: The prioritised board of work RankX AI generates from everything it finds.
  - [Tasks](https://rankxai.com/docs/tasks): The prioritised board RankX AI builds from everything it finds. How tasks are created, why they are deduplicated, and what a task carries with it.
  - [The Task Creation Assistant](https://rankxai.com/docs/tasks/task-creation-assistant): Turning an audit finding into a properly written task, with steps and a definition of done. What it costs, when to use it, and when not to.

- **Connect**
- Integrations: Connecting RankX AI to WordPress, WooCommerce and Google, and what to do when a connection stops answering.
  - [Integrations](https://rankxai.com/docs/integrations): What RankX AI connects to, what each connection unlocks, and the rules every write obeys. Includes the two things RankX AI deliberately will not do.
  - [WordPress](https://rankxai.com/docs/integrations/wordpress): Connect WordPress to RankX AI with an Application Password, and understand what is writable on your site, what is refused, and why every write is read back.
  - [Troubleshooting connections](https://rankxai.com/docs/integrations/troubleshooting-connections): What to do when a WordPress or Google connection stops answering in RankX AI. Symptom first, with the difference between a refusal and a zero.
  - [WooCommerce](https://rankxai.com/docs/integrations/woocommerce): Reading and improving a WooCommerce catalogue from RankX AI. What it can change, the four things it deliberately cannot, and why products have no undo.
- MCP server: Drive RankX AI from an AI assistant over the Model Context Protocol.
  - [MCP server](https://rankxai.com/docs/mcp): Drive RankX AI from Claude, ChatGPT, Cursor or a script over the Model Context Protocol, with a documented tool surface and ready-made Agent Skills.
  - Connect a client: Per-client setup for Claude, ChatGPT, the editors, and scripts.
    - [Connect Claude Desktop and Claude Web](https://rankxai.com/docs/mcp/connect/claude-desktop): Connect RankX AI to Claude through the Connectors panel with OAuth, plus the config-file trap that costs people an afternoon.
    - [Connect Claude Code](https://rankxai.com/docs/mcp/connect/claude-code): One command connects Claude Code to RankX AI, with either OAuth or a personal access token. Both forms, and when to pick which.
    - [Connect ChatGPT](https://rankxai.com/docs/mcp/connect/chatgpt): Connect RankX AI to ChatGPT as a custom connector using OAuth. The steps, the owner requirement, and the one status message that is not ours.
    - [Connect Cursor, VS Code and Windsurf](https://rankxai.com/docs/mcp/connect/cursor-vscode-windsurf): Add RankX AI to an editor's MCP configuration with a bearer token. The three config blocks, whose key names differ, and how to keep the token out of git.
    - [Scripts and CI](https://rankxai.com/docs/mcp/connect/scripts-and-ci): Call RankX AI's MCP server directly with a bearer token. The JSON-RPC sequence in cURL, Node and Python, and why OAuth is not an option here.
  - [Authentication and scopes](https://rankxai.com/docs/mcp/authentication): How RankX AI's MCP server authenticates. OAuth against personal access tokens, the scopes, client-scoped tokens, rate limits and revocation.
  - Tool reference: Every tool the RankX AI MCP server exposes, generated from the product's own contract.
    - [Tool reference](https://rankxai.com/docs/mcp/tool-reference): Every tool the RankX AI MCP server exposes, with its required scope and its inputs. Generated from the product's own contract rather than typed by hand.
    - [Websites, brand and AI visibility](https://rankxai.com/docs/mcp/tool-reference/visibility-and-brand): The MCP tools that resolve a Website, read its brand profile and competitors, manage tracked prompts, and read AI visibility and AI Shopping.
    - [Rankings and Google data](https://rankxai.com/docs/mcp/tool-reference/rankings-and-google-data): The MCP tools for tracked keywords, AI Overviews, Search Console, Analytics and index coverage, and the refusals that stop a missing connection reading as zero.
    - [Keywords and content](https://rankxai.com/docs/mcp/tool-reference/content-and-keywords): The MCP tools for keyword discovery, search trends, topic clusters, content briefs and article generation, and the two that dispatch and poll.
    - [Audits, tasks and credits](https://rankxai.com/docs/mcp/tool-reference/audit-tasks-and-credits): The MCP tools for running a Website Audit, working the Tasks board, reading the change timeline and checking the credit wallet.
    - [WordPress and WooCommerce](https://rankxai.com/docs/mcp/tool-reference/wordpress): The MCP tools that change a live public website, the three scopes they sit behind, and the five rules every one of them obeys.
  - [Agent Skills](https://rankxai.com/docs/mcp/agent-skills): The ready-made workflows that turn RankX AI's tool list into a job. What each one does, how to install it, and the guarantees they all carry.
  - [Examples](https://rankxai.com/docs/mcp/examples): Twelve worked recipes for RankX AI over MCP. The prompt to paste, the tool sequence it produces, and what to watch for in the answer.
  - [MCP troubleshooting](https://rankxai.com/docs/mcp/troubleshooting): Why a tool is missing, why a connector will not attach, what each refusal means, and the two client traps that cost the most time.

- **Agency**
- Running an agency: Client workspaces, roles and permissions, per-client budgets, white label, reports and the client portal.
  - [Running an agency](https://rankxai.com/docs/agencies): How the RankX AI agency track is organised. Client Workspaces, roles, the seven visibility permissions, per-client budgets, white label and the client portal.
  - [Client Workspaces](https://rankxai.com/docs/agencies/client-workspaces): One workspace per client in RankX AI. What a workspace holds, how the Website pool works, and what happens when you remove one.
  - [Roles and permissions](https://rankxai.com/docs/agencies/roles-and-permissions): The four RankX AI roles, what each can do, why only one can approve an MCP connection, and why Agency Clients do not consume seats.
  - [What clients can see](https://rankxai.com/docs/agencies/what-clients-can-see): The seven per-workspace switches deciding which sections an Agency Client sees, why absent means allowed, and the two surfaces that are ungoverned.
  - [Per-client credit budgets](https://rankxai.com/docs/agencies/per-client-credit-budgets): A ceiling on the shared agency wallet, not a sub-wallet. Why the wallet can be full while a client is stopped, and what uncapped and zero each mean.
  - [White label](https://rankxai.com/docs/agencies/white-label): Putting your agency's brand on RankX AI. Custom domain, logo, colours and sending address, and the one place the platform domain still shows.
  - [Client reports](https://rankxai.com/docs/agencies/client-reports): Scheduled monthly reports with a written narrative, delivered by email with a share link. What the narrative costs, and why it degrades rather than blocking.
  - [The client portal](https://rankxai.com/docs/agencies/client-portal): Where an Agency Client logs in. What they see, what they cannot reach, and what to check before you invite anyone.

- **Account**
- Your account: Plans, limits, the trial, billing, seats and security.
  - [Plans and limits](https://rankxai.com/docs/account/plans-and-limits): Every published RankX AI plan limit, on both tracks, generated from the same source the pricing page renders. What each limit caps, and what it does not.
  - [The free trial](https://rankxai.com/docs/account/trial): RankX AI's trial does not start at signup. It starts when the onboarding package completes, and this page explains why and what the grant funds.
  - [Credits and billing](https://rankxai.com/docs/account/credits-and-billing): Your credit balance, where credits went, the monthly grant that does not roll over, top-up packs, and the four refusals with four different remedies.
  - [Email sending](https://rankxai.com/docs/account/email-sending): Sending RankX AI email from your own address. Domain authentication, per-client template overrides, and what still arrives from the platform.
  - [Security](https://rankxai.com/docs/account/security): Your RankX AI account's security settings, how sessions are revoked, what credentials exist, and what to do if one leaks.
  - [Team and seats](https://rankxai.com/docs/account/team-and-seats): Inviting people to RankX AI, what a seat counts, why Agency Clients do not consume one, and what happens to credentials when someone leaves.
- Reference: Generated tables read from RankX AI itself: credit costs, plan limits, tracked platforms, AI Readiness checks, share links and the changelog.
  - [Credit costs](https://rankxai.com/docs/reference/credit-costs): What each RankX AI action costs, and the unit it is charged per. The only page in this documentation that prints a credit number.
  - [Plan limits](https://rankxai.com/docs/reference/plan-limits): Every published RankX AI limit on both tracks, as one generated table, read from the same source the pricing page renders.
  - [Tracked platforms](https://rankxai.com/docs/reference/tracked-platforms): Every surface RankX AI watches, what each is good for, how RankX AI reaches it, and what widens it. Generated from the site's own platform list.
  - [AI Readiness checks](https://rankxai.com/docs/reference/ai-readiness-checks): Every check RankX AI's AI Readiness actually runs, with its category and its weight, generated from the product so it cannot list one that is not run.
  - [Share links](https://rankxai.com/docs/reference/share-links): The four RankX AI surfaces that can be shared without a login, what each exposes, and the one rule that governs all of them.
  - [Documentation changelog](https://rankxai.com/docs/reference/changelog): What changed in these documentation pages and when, plus how to tell whether a generated reference table is current.

## Elsewhere

- [RankX AI](https://rankxai.com/): what the product does.
- [Curated brand file](https://rankxai.com/llms.txt): the short version of this site.
- [Full content corpus](https://rankxai.com/llms-full.txt): every page as one file.