A skill teaches your assistant how to install bseoa, build the right command, run the audit and explain the findings. One ZIP works in every assistant that can run commands.
There are two ways to put bseoa inside your assistant. This page covers the skill.
Instructions the assistant reads. Works anywhere it can run commands. Downloads the CLI on first use.
Nine tools the assistant calls directly. Desktop hosts today, browser hosts coming.
Set up the connector →bseoa/, with a SKILL.md inside. In assistants that can run commands (Claude Code, Codex, Claude.ai) the skill installs the CLI itself when it is missing.
Optional: if the bseoa CLI is already installed on your machine, store your key once so every assistant can use it.
bseoa license store <your-license-key> bseoa license status
bseoa and black-seo-analyzer are the same binary.
In the terminal or your IDE.
Unzip the skill into your skills folder, so that SKILL.md ends up at skills/bseoa/SKILL.md:
~/.claude/skills/ (macOS / Linux) %USERPROFILE%\.claude\skills\ (Windows)
Open a new session and type /bseoa followed by what you want.
For structured tools instead of the full CLI, add the connector:
claude mcp add bseoa -s user -- bseoa mcp
Add -e BLACK_SEO_ANALYZER_KEY=<key> if you did not run bseoa license store.
Uses the connector bundle. Nothing else needs to be on your PATH.
Download the bundle for your OS, double-click it, enter your key. Claude Desktop installs the bundled binary and stores the key as a secret.
The skill runs in Claude's code execution sandbox and downloads the Linux CLI there on first use.
download.blackseoanalyzer.com and the domain of each site you want to audit. The sandbox cannot reach anything else.
The sandbox resets each conversation, so the CLI is downloaded again each time and crawl history does not persist. For persistent history use Claude Desktop or Claude Code.
Team and Enterprise: an owner must first enable code execution and file creation, and Skills, under Organization settings → Plugins & skills. Skills are still uploaded per user.
Runs on your machine.
Unzip the skill into your skills folder, so that SKILL.md ends up at skills/bseoa/SKILL.md:
~/.agents/skills/ (macOS / Linux) %USERPROFILE%\.agents\skills\ (Windows)
Invoke it with $bseoa, or let Codex pick it up when your prompt is about an SEO audit.
codex mcp add bseoa -- bseoa mcp
Skills live in ChatGPT Work on paid plans.
In ChatGPT Work (paid plans), upload the skill ZIP under Skills, then ask for an SEO audit and mention bseoa. Whether ChatGPT's container can download and run the CLI is being verified; if it cannot, use Codex CLI above or wait for the hosted connector.
Connector: coming. See the connector page.
Needs the PerplexityXPC helper, which the app offers to install.
bseoa license store <key>. The connector has nowhere to put an environment variable.
On the Simple tab, name it bseoa and enter the command:
/usr/local/bin/bseoa mcp --db-path /Users/you/bseoa-crawl.db
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).
SKILL.md, up to 10 MB).
SKILL.md file from inside it.
Running the CLI inside Computer is being verified. Until it is, use Perplexity for Mac above or wait for the hosted connector.
SKILL.md from the ZIP as a file, or open Skill Creator and paste its contents when it asks what the skill should do.
Grok can plan and interpret audits with it today; running audits from Grok arrives with the hosted connector.
grok.com/connectors → New Connector → Custom. URL coming. See the connector page.
Audit https://example.com and give me the five highest-impact fixes.
Check only https://example.com/pricing. What would stop it ranking?
Crawl https://example.com, then show every page with a missing or duplicate meta description.
How will these three URLs look in Google? [urls]
Compare today's crawl with yesterday's. What regressed?
no_licenseThe connector starts without a key on purpose. Run bseoa license store <key> (or set BLACK_SEO_ANALYZER_KEY in the host's env block) and restart the host, since the license is checked once at startup.
Hosts do not use your shell PATH. Put the absolute path to bseoa in the config.
list_crawls is empty after a crawlTwo different working directories, so two different crawl.db files. Pass an absolute --db-path.
The sandbox's network allowlist is blocking download.blackseoanalyzer.com. Add it where the tool lets you (Claude.ai does), or use a desktop host.
Those sites block crawlers by design. Your links are fine.
Every feature, no page limit, no credit card. Get a key, add the skill to your assistant and ask for an audit.