Black SEO Analyzer logo

A technical SEO crawler your AI assistant can call.

The bseoa connector gives Claude, ChatGPT and any MCP host eleven audit tools: check a page, crawl a site, rank the issues, compare two crawls. The answers come from 300+ checks run on your pages, and the results are kept between chats.

Free for 14 days, no card. Then $29/month.

Rather run it on your own machine? Set it up in Claude Desktop, or in Claude Code, Cursor, VS Code, Codex and Perplexity.

Start here

In Claude and ChatGPT: the hosted connector

Browser assistants can't run a program on your computer, so this connector runs the crawls on our servers and keeps the results for your account. Nothing to install.

  1. 1

    Add the connector

    Open Black SEO Analyzer in Claude's directory and click Connect, or open it in ChatGPT and add it.

  2. 2

    Sign in with your email

    The first time, you get 14 days of hosted crawling free, no card.

  3. 3

    Ask in plain words

    “Audit example.com.” “Check this page.” There are prompts to try below.

Runs on our servers

Hosted connector

$29/month

Or $290 a year. 25,000 crawled pages every rolling 30 days, up to 2,000 pages per crawl, and crawl results kept 90 days.

Own a Single or Agency License? The hosted connector is $15/month or $120/year. When the trial ends, pick a plan on the pricing page; in Claude, the assistant can also give you the checkout link. JavaScript rendering runs only on the desktop app and CLI.

Any other assistant that takes a remote MCP connector URL with sign-in can use this URL:

https://mcp.blackseoanalyzer.com/mcp

Step by step, with prompts to try: Black SEO Analyzer for Claude and for ChatGPT. Questions are on the connector FAQ; problems on the troubleshooting page.

Prefer to crawl from your own machine instead? Install the bseoa skill.

On your machine

Claude Desktop: one click

Double-click the bundle. Claude Desktop installs it and asks for your license key.

Windows

For Claude Desktop on 64-bit Windows.

Download bundle

macOS

For Claude Desktop on macOS (Apple silicon and Intel).

Download bundle

Linux

For Claude Desktop builds on 64-bit Linux.

Download bundle

On your machine

Other desktop hosts

Each host below starts the same local MCP server with bseoa mcp.

bseoa and black-seo-analyzer are the same binary; if yours is installed under the long name, use that name in the configs or add a symlink. Hosts do not always inherit your shell PATH: if one reports command not found, use the absolute path from which bseoa (where bseoa on Windows).

Claude Code

claude mcp add bseoa -s user -- bseoa mcp

Store your key first: bseoa license store <key>.

Cursor

Add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "bseoa": {
      "command": "bseoa",
      "args": ["mcp"]
    }
  }
}

Store your key first: bseoa license store <key>.

VS Code

code --add-mcp "{\"name\":\"bseoa\",\"command\":\"bseoa\",\"args\":[\"mcp\"]}"

Store your key first: bseoa license store <key>.

Codex CLI

codex mcp add bseoa -- bseoa mcp

Store your key first: bseoa license store <key>.

Perplexity for Mac

Go to Settings → Connectors → Add Connector → MCP and enter this command:

/usr/local/bin/bseoa mcp --db-path /Users/you/bseoa-crawl.db

Install the PerplexityXPC helper when the app offers it, run bseoa license store first, and use the absolute path: the helper does not read your shell PATH. Replace /usr/local/bin/bseoa with the output of which bseoa if you installed it elsewhere (the skill installs to ~/.local/bin).

The eleven tools

check_page
Audit one URL immediately and return its SEO issues. The fast path for "what is wrong with this page?".
start_crawl
Start crawling a whole site in the background and return a job id immediately.
crawl_status
Report the progress and state of a background crawl started by start_crawl.
list_crawls
List the crawl sessions stored in the database with their start URL, dates and page count.
issues_summary
Summarize a crawl: counts by severity, category and issue key, with example URLs per key.
query_issues
List individual bseoa.issue/v1 issues from a crawl, filtered by severity, key, category or URL prefix.
page_report
Report everything recorded about one crawled URL, including its full issue list. Never returns page HTML.
compare_crawls
Compare two crawls and report new, fixed and persisting issues.
serp_preview
Show how each URL's title and description will look in a search result, including truncation.
search_docs
Search bseoa's own documentation: what a tool, flag or setting does, limits, pricing, licenses, the hosted plan and what an issue key means. Answers come from these pages, not from a web search.
account_status
Hosted only. Report your plan, the pages used and left in the rolling 30 days, how long results are kept, and what you can buy. Read-only: it never starts a purchase.

Inputs, limits and every error code are on the connector reference.

What to ask

Ask in plain language; your assistant picks the tools. These work as written. demo.blackseoanalyzer.com is a made-up bakery site we keep with known problems, so you can try them before pointing bseoa at your own site.

  1. Check one page

    Check https://demo.blackseoanalyzer.com/contact for SEO problems.

    Runs check_page in seconds and reports what's wrong with that page, worst first, with how to fix each one. Here it finds that the contact page is set to noindex, so search engines leave it out.

  2. Audit a site and prioritize the fixes

    Audit https://www.blackseoanalyzer.com/ up to 5 pages and tell me what to fix first.

    Starts a crawl with start_crawl, waits on crawl_status, then reads issues_summary and query_issues to rank the fixes: broken links, redirect chains, missing titles and duplicate descriptions ahead of minor hints.

  3. See what changed since the last crawl

    Compare my last two crawls of demo.blackseoanalyzer.com. What improved and what got worse?

    Finds both crawls with list_crawls and runs compare_crawls: the issues fixed, the new ones, and the ones still there. Run the audit above twice, or after you fix something, to have two crawls to compare.

  4. Preview the search result

    How will https://demo.blackseoanalyzer.com/ and /menu look in Google?

    Uses serp_preview to show each title and description as a search result would, including where they'd be cut off.

bseoa reads and reports; it never logs in to your site or changes it. Ask it to edit your CMS and your assistant will say it can't.

Directory reviewers

We give each directory a test account with hosted access and sample data. Its sign-in details are in the submission's test-account field, never on this page.

Help and privacy

Ask it about your own site

Free for 14 days, no card.

Or download the desktop app for Windows, Mac or Linux.