# Rankbox Docs > Documentation for Rankbox (https://rankbox.xyz), the AI search growth engine: research the questions buyers ask AI engines, write source-backed articles, publish them to your site, build backlinks and draft Reddit replies. Covers the product, publishing integrations, the REST API, the MCP server, and agent access (AI agents creating and running Rankbox accounts). How to read these docs as an agent: - Every page is available as Markdown: add `.md` to its URL (for example https://rankbox.xyz/docs/api/articles.md), or request the page with `Accept: text/markdown`. - Start with the agent quickstart if you are setting up Rankbox for a person or a project: https://rankbox.xyz/docs/agents/quickstart.md - Section headings are stable anchors: `## 402 Subscription required` is `#402-subscription-required`. - Prices, allowances and limits stated in these pages are current as of each page's `Last updated` date. ## Get started What Rankbox is, a 10-minute quickstart, and the ideas the rest of the docs build on. - [What is Rankbox?](https://rankbox.xyz/docs/get-started/introduction.md): What Rankbox does from site scan to published article, who it is for, what it deliberately does not do, the plan in brief, and where to go next. - [Quickstart: from sign-up to your first published article](https://rankbox.xyz/docs/get-started/quickstart.md): A step-by-step tutorial to create a Rankbox account, confirm a content plan, start the trial, write a first article, publish it and check autopilot. - [How Rankbox works](https://rankbox.xyz/docs/get-started/how-it-works.md): The full Rankbox pipeline: site scan, research, content plan, writing, scoring, publishing, live URLs, backlinks, Reddit and Rank, with credit costs. - [Core concepts](https://rankbox.xyz/docs/get-started/core-concepts.md): Precise definitions of Rankbox's building blocks: account, site, content plan, article statuses, credits, autopilot, score, API key, live URL and trial. - [Onboarding, step by step](https://rankbox.xyz/docs/get-started/onboarding.md): Every step and field of Rankbox onboarding, what Rankbox does with each answer, what confirming saves to your site, and where to change it later. - [A tour of the dashboard](https://rankbox.xyz/docs/get-started/dashboard-tour.md): What every page in the Rankbox dashboard is for, the key elements on each, the site switcher for Studio accounts, the phone layout and keyboard shortcuts. ## Content engine Research, the content plan, how articles are written, edited, scored and put on autopilot. - [Research: the questions buyers ask AI](https://rankbox.xyz/docs/content/research.md): How Rankbox reads your site, estimates the searches and questions your buyers ask, and turns them into a keyword set and a plan of article topics. - [Content plan and calendar](https://rankbox.xyz/docs/content/content-plan.md): How topics become scheduled articles: ideas, the autopilot queue, article statuses, the Calendar, moving dates, and what happens when credits run out. - [How articles are written](https://rankbox.xyz/docs/content/writing.md): The Rankbox article pipeline stage by stage: live research, drafting, revision passes, sources, video, writer notes, length, credits and failures. - [Editing articles](https://rankbox.xyz/docs/content/editor.md): Every action in the Rankbox article editor: editing text, AI rewrites, title and meta, saving, publishing changes, scheduling, deleting and shortcuts. - [Brand voice and writing settings](https://rankbox.xyz/docs/content/brand-voice.md): Set the brand, audience, tone, writing style and house rules Rankbox writes with, see the exact brief the writer reads, and write house rules that work. - [The SEO and GEO score](https://rankbox.xyz/docs/content/scoring.md): Every check behind the Rankbox article score, how points are weighted and calculated, what each check means for Google and AI engines, and how to raise it. - [Autopilot and the publishing schedule](https://rankbox.xyz/docs/content/autopilot.md): What Rankbox autopilot does on each run, the pace options, what it needs to write, pausing and resuming, and how it sends articles to Webflow and Shopify. ## Publishing Get finished articles onto your site: Webflow, Shopify, Framer, WordPress or any stack. - [How publishing works](https://rankbox.xyz/docs/publishing/overview.md): How finished Rankbox articles reach your website, the push and pull models, what each destination receives, and how slugs, edits and deletions behave. - [Publish to Webflow](https://rankbox.xyz/docs/publishing/webflow.md): Connect Webflow with Webflow sign-in, choose a CMS collection, map its fields, and let Rankbox write every finished article into it as a live item or a draft. - [Publish to Shopify](https://rankbox.xyz/docs/publishing/shopify.md): Install the Rankbox app in Shopify, link it to a Rankbox site with an API key, pick a blog, and let every finished article arrive as a native blog post. - [Sync articles to Framer](https://rankbox.xyz/docs/publishing/framer.md): Use the Rankbox plugin to sync finished articles into a Framer CMS collection, report live URLs back, and add site-wide article structured data. - [Publish to WordPress](https://rankbox.xyz/docs/publishing/wordpress.md): Publish finished Rankbox articles as WordPress posts today, with a complete plugin file or a scheduled script that uses the WordPress REST API. - [Publish to any website with the REST API](https://rankbox.xyz/docs/publishing/custom-sites.md): Working recipes for pulling finished Rankbox articles into Next.js, Astro, static site generators or your own database, and reporting live URLs back. - [Live URLs and verification](https://rankbox.xyz/docs/publishing/live-urls.md): How Rankbox learns where each article went live, the rules a live URL must follow, and how the backlink exchange verifies links on that page. ## Authority and reach The backlink exchange, Reddit Presence, the Rank page and the free tools. - [The backlink exchange](https://rankbox.xyz/docs/growth/backlink-exchange.md): How the Rankbox backlink exchange works for paid members, from credits and matching to verification, placement statuses, clawbacks and Studio rules. - [Reddit Presence](https://rankbox.xyz/docs/growth/reddit-presence.md): How Reddit Presence finds the threads your buyers read, drafts a disclosed reply you post yourself, checks it, and tracks the thread afterwards. - [Rank: market coverage and AI readiness](https://rankbox.xyz/docs/growth/rank.md): What the Rank page shows, where each number comes from, how to act on it, and what it doesn't measure, including AI citations and live rankings. - [Free SEO and AI search tools](https://rankbox.xyz/docs/growth/free-tools.md): Every free Rankbox tool at /tools, what each one does, which ones use AI, the per-IP limit on AI runs, and how they relate to the paid product. ## AI tools and MCP Use Rankbox from Claude, ChatGPT, Cursor and 46 other AI tools through the MCP server. - [The Rankbox MCP server](https://rankbox.xyz/docs/ai-tools/mcp-server.md): The Rankbox MCP server at rankbox.xyz/mcp, covering transport, its three tools, access and limits, and how to test it with MCP Inspector or curl. - [Connect your AI tools](https://rankbox.xyz/docs/ai-tools/connect-ai-tools.md): Add the Rankbox MCP server to Claude, ChatGPT, Cursor, VS Code, Lovable and 44 more AI tools, check that it works, and fix common setup problems. - [MCP tool reference](https://rankbox.xyz/docs/ai-tools/tools-reference.md): Exhaustive reference for the three Rankbox MCP tools, with every input and limit, the output shape, real example results, errors and example prompts. ## REST API Pull finished articles into any CMS and report where they went live. - [API overview](https://rankbox.xyz/docs/api/overview.md): The Rankbox REST API lets your site pull finished articles and report where each one went live. Base URL, conventions, endpoints and a first request. - [Authentication and API keys](https://rankbox.xyz/docs/api/authentication.md): How Rankbox API keys work: the rv_live_ format, one key per site, creating, replacing and revoking keys, the Authorization header, and storing keys safely. - [Articles endpoints](https://rankbox.xyz/docs/api/articles.md): Reference for GET /articles, GET /articles/{id} and PATCH /articles/{id}, with every parameter, the Article object, full examples and status codes. - [Ping endpoint](https://rankbox.xyz/docs/api/ping.md): GET /ping checks a Rankbox API key and returns the brand, website and logo of the site it belongs to. Call it when someone connects your integration. - [Syncing articles reliably](https://rankbox.xyz/docs/api/syncing.md): Patterns for keeping a site in step with Rankbox: cursor paging with next_since, catch-up, full walks for deletions, content hashes, stable slugs and retries. - [Errors](https://rankbox.xyz/docs/api/errors.md): Every error the Rankbox REST API returns: the JSON error format, each status code and its exact message, the causes, and how your integration should respond. - [Rate limits](https://rankbox.xyz/docs/api/rate-limits.md): The Rankbox API's request limits: 300 per IP address and 120 per account in each one-minute window, what counts, the 429 response, and how to stay under them. - [TypeScript client and plugin starter](https://rankbox.xyz/docs/api/client-library.md): The TypeScript client behind Rankbox's own Framer plugin: methods, errors, retry rules, a copy for your project, and the plugin starter it builds on. - [Build a CMS integration](https://rankbox.xyz/docs/api/build-an-integration.md): A step-by-step guide to a production Rankbox integration for any CMS: connect with ping, sync, map fields, protect CMS edits, report live URLs, handle deletes. ## Agent access AI agents create Rankbox accounts and run the whole platform through the API or MCP. - [Agent access](https://rankbox.xyz/docs/agents/overview.md): How AI agents create Rankbox accounts or connect to existing ones, then run research, writing, publishing and billing through the API or MCP. - [Quickstart for AI agents](https://rankbox.xyz/docs/agents/quickstart.md): Step-by-step instructions an AI agent can execute: create a Rankbox account, start the trial, plan, generate, publish, turn on autopilot and listen for events. - [Create an account as an agent](https://rankbox.xyz/docs/agents/create-account.md): Create a Rankbox account for a person or business with one API call: fields, the agent key, the claim email, duplicate emails, validation and abuse limits. - [Agent authentication](https://rankbox.xyz/docs/agents/authentication.md): How agents authenticate with Rankbox: rv_agent_ keys, OAuth 2.1 with PKCE and dynamic client registration, dashboard keys, rotation, revocation and site keys. - [Agent API reference](https://rankbox.xyz/docs/agents/api-reference.md): Every endpoint of the Rankbox agent API: conventions, objects, parameters and example requests and responses for accounts, sites, articles, billing and more. - [Agent MCP tools](https://rankbox.xyz/docs/agents/mcp.md): Connect an agent to the Rankbox MCP server with an agent key or OAuth and use the full tool set: inputs, outputs, example calls and anonymous access. - [Events and webhooks](https://rankbox.xyz/docs/agents/events.md): Every Rankbox event type with payloads, how to register signed webhooks, verify the HMAC signature in TypeScript or Python, handle retries and poll GET /events. - [Billing, credits and limits](https://rankbox.xyz/docs/agents/billing-and-limits.md): What agents can do before a plan, how the trial and the owner's card work, article, backlink and Reddit credits, Studio, rate limits and each 402. - [Permissions and guardrails](https://rankbox.xyz/docs/agents/permissions.md): The full-access model for agents, the few moments that need a person and why, the activity log, revocation, owner controls, security advice and acceptable use. - [Agent playbooks](https://rankbox.xyz/docs/agents/playbooks.md): End-to-end recipes for agents: launch a content engine, add Rankbox to a Next.js site, run client sites with Studio, a weekly loop and error recovery. ## Account and billing The plan, credits, the free trial, billing, Studio sites, settings and security. - [Plans and credits](https://rankbox.xyz/docs/account/plans-and-credits.md): What the Rankbox Business plan includes, how article, backlink and Reddit credits are granted, spent and reset, and what happens when one runs out. - [The free trial](https://rankbox.xyz/docs/account/free-trial.md): How the 7-day Rankbox trial works, from adding a card in Stripe Checkout to automatic conversion, early upgrade, cancelling and a failed card. - [Billing, invoices and cancellation](https://rankbox.xyz/docs/account/billing.md): How Rankbox billing works: what Plan & Billing shows, the Stripe portal for cards, invoices and cancelling, plus refunds and failed payments. - [Studio: run several sites](https://rankbox.xyz/docs/account/studio.md): How Studio adds extra sites to one Rankbox account at $49.50 a month each, with prorated charges, per-site allowances, switching, removal and restore. - [Account and site settings](https://rankbox.xyz/docs/account/settings.md): Every section and field in Rankbox Settings, from brand and writing voice to autopilot pace, Studio and your account, and how autosave works. - [Security and privacy](https://rankbox.xyz/docs/account/security.md): How Rankbox protects your account and data: sign-in, connected apps, API keys, platform tokens, payments, subprocessors, retention and deletion. ## Help Answers to common questions, fixes for known problems, and how to reach us. - [Frequently asked questions](https://rankbox.xyz/docs/help/faq.md): Direct answers to the questions people ask most about Rankbox: setup, articles, publishing, backlinks, Reddit, billing, the API and AI agents. - [Troubleshooting](https://rankbox.xyz/docs/help/troubleshooting.md): Fixes for Rankbox problems by area, from sign-in and onboarding to API errors, Webflow, Shopify, backlinks, Reddit and Studio, quoting exact messages. - [Get help](https://rankbox.xyz/docs/help/support.md): How to contact Rankbox support, what to include in a request, where to raise billing errors and security issues, and where to follow product changes. ## Optional - [All docs in one file](https://rankbox.xyz/docs/llms-full.txt): Every page above, concatenated, for loading the whole knowledge base at once. - [Rankbox site index](https://rankbox.xyz/llms.txt): Marketing pages, guides, glossary and free tools. - [MCP server](https://rankbox.xyz/mcp): Streamable HTTP MCP endpoint for AI tools.