{"id":"io.github.sethblack/bseoa","slug":"io-github-sethblack-bseoa","title":"Black SEO Analyzer","description":"Technical SEO audits: check a page or crawl a whole site, locally or hosted. Compares crawls.","version":"26.11.18","publisher":{"kind":"github","id":"sethblack","label":"@sethblack on GitHub","url":"https://github.com/sethblack"},"website":"https://www.blackseoanalyzer.com/","repository":"https://github.com/sethblack/black-seo-analyzer","remotes":[{"type":"streamable-http","url":"https://mcp.blackseoanalyzer.com/mcp"}],"packages":[{"registryType":"mcpb","identifier":"https://github.com/sethblack/black-seo-analyzer/releases/download/v26.11.18/bseoa-26.11.18-win32.mcpb","version":"26.11.18","fileSha256":"73763b0228ce9d9d5386562812964026d61bcc9342cd7817be3db67a7c7bcb57","transport":{"type":"stdio"},"packageArguments":[{"description":"Serves the MCP tool surface over stdio.","type":"positional","value":"mcp","valueHint":"subcommand"},{"description":"Path to the SQLite database holding crawl results. Defaults to crawl.db in the working directory; set it to a stable absolute path so crawl history survives between sessions.","type":"named","name":"--db-path"}],"environmentVariables":[{"description":"Black SEO Analyzer license key. Start a free 14-day trial at https://www.blackseoanalyzer.com/free-trial. Without it every tool returns a license error.","isRequired":true,"isSecret":true,"name":"BLACK_SEO_ANALYZER_KEY"}]},{"registryType":"mcpb","identifier":"https://github.com/sethblack/black-seo-analyzer/releases/download/v26.11.18/bseoa-26.11.18-darwin.mcpb","version":"26.11.18","fileSha256":"99c8b57d8c010b916296e9406ca51fe6c4ce57bed18c9a2e8329210f8928d76c","transport":{"type":"stdio"},"packageArguments":[{"description":"Serves the MCP tool surface over stdio.","type":"positional","value":"mcp","valueHint":"subcommand"},{"description":"Path to the SQLite database holding crawl results. Defaults to crawl.db in the working directory; set it to a stable absolute path so crawl history survives between sessions.","type":"named","name":"--db-path"}],"environmentVariables":[{"description":"Black SEO Analyzer license key. Start a free 14-day trial at https://www.blackseoanalyzer.com/free-trial. Without it every tool returns a license error.","isRequired":true,"isSecret":true,"name":"BLACK_SEO_ANALYZER_KEY"}]},{"registryType":"mcpb","identifier":"https://github.com/sethblack/black-seo-analyzer/releases/download/v26.11.18/bseoa-26.11.18-linux.mcpb","version":"26.11.18","fileSha256":"119ce3d160d90d524bdda05d041bcb12f560bb0faa3a02e347d2faed33dad447","transport":{"type":"stdio"},"packageArguments":[{"description":"Serves the MCP tool surface over stdio.","type":"positional","value":"mcp","valueHint":"subcommand"},{"description":"Path to the SQLite database holding crawl results. Defaults to crawl.db in the working directory; set it to a stable absolute path so crawl history survives between sessions.","type":"named","name":"--db-path"}],"environmentVariables":[{"description":"Black SEO Analyzer license key. Start a free 14-day trial at https://www.blackseoanalyzer.com/free-trial. Without it every tool returns a license error.","isRequired":true,"isSecret":true,"name":"BLACK_SEO_ANALYZER_KEY"}]}],"published":"2026-11-17","updated":"2026-11-17","status":"online","auth":"","latency_ms":944,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"account_status","title":"Account status","description":"Report this account's plan and usage live: whether hosted audits are active, the page budget used and remaining in the rolling 30 days and when it resets, how long crawl sessions are kept, and the licenses on the account. Call it when a tool returned trial_expired, no_hosted_addon or quota_exceeded, when the user says their plan has changed, or when they ask what their plan includes. Read-only: it","read_only":true},{"name":"check_page","title":"Check one page","description":"Audit one URL immediately and return its SEO issues (schema bseoa.issue/v1: key, category, severity, message, fix_hint, docs_url). This is the fast path and the right first call for \"what is wrong with this page?\" - it fetches a single page and never follows links. Prefer it over start_crawl whenever the user asked about one specific page rather than a whole site, and that includes a site's homepa","read_only":false},{"name":"compare_crawls","title":"Compare crawls","description":"Compare two crawls of the same site and report which issues are new in the later crawl, which were fixed, and how many persist. Use it to answer \"did my changes help?\" or \"what regressed since the last deploy?\", and to gate a release: only the new_issues list represents a regression, so a pre-existing backlog never counts against a change. Get both session ids from list_crawls; base_session is the","read_only":true},{"name":"crawl_status","title":"Crawl status","description":"Report the progress of a crawl started by start_crawl: state (\"queued\", \"running\", \"finished\" or \"failed\"), the crawl session_id to read results from, the pages stored so far, and the error text if it failed. Poll every few seconds; a queued crawl starts as soon as the worker is free. Do not call issues_summary or query_issues for that crawl until state is \"finished\", or you will read a partial re","read_only":true},{"name":"issues_summary","title":"Issue summary","description":"Summarize a crawl: total issue count, counts by severity and by category, and every distinct issue key with how many pages it affects plus up to five example URLs. Always call this before query_issues - it is small, it tells you which keys are worth drilling into, and it is what you should base a prioritized fix plan on. Omit session_id to summarize the account's most recent crawl.","read_only":true},{"name":"list_crawls","title":"List crawls","description":"List the crawl sessions stored for this account, newest last, with their session_id, start URL, start and end times, and page count. Single-page checks made with check_page are not crawls and are not listed. Call this first when the user refers to \"the last crawl\" or when you need a session_id for issues_summary, query_issues, page_report or compare_crawls. A session with no end time is still runn","read_only":true},{"name":"page_report","title":"Page report","description":"Report everything recorded about one crawled URL: status code, redirect target, title and meta description, Open Graph tags, word count, link and asset counts, headings, TTFB, Web Vitals score, and the full issue list for that page. Use it after query_issues or issues_summary when you need the context behind a specific page's issues. It never returns the page's HTML source; to inspect markup, fetc","read_only":true},{"name":"query_issues","title":"Query issues","description":"List individual issues from a crawl, filtered by severity, issue key, category or URL prefix, as bseoa.issue/v1 records with the affected URL, the localized message, a fix hint and a docs link. Returns at most 100 issues per call: when the response has a non-null next_offset there are more, so call again with offset set to that value. Narrow with min_severity or key from issues_summary rather than","read_only":true},{"name":"search_docs","title":"Search the bseoa documentation","description":"Search Black SEO Analyzer's own documentation and return the matching sections with their URLs. Use it for questions about bseoa itself: what a tool, command, flag or setting does, crawl limits and the page budget, licenses and the hosted plan, installing or configuring the CLI, GUI or connector, or what an issue key means (pass issue_key for that issue's reference page with its fix). Pass query f","read_only":true},{"name":"serp_preview","title":"Search snippet preview","description":"Fetch each URL and report how its title and meta description will look in a search result: character length, pixel width, whether the engine will truncate it, and the Open Graph and Twitter Card fallbacks. Use it when the user asks how a page \"looks in Google\" or is rewriting titles and descriptions - it is about the snippet, not the page's other SEO problems, which check_page covers. At most 50 U","read_only":true},{"name":"start_crawl","title":"Start a site crawl","description":"Queue a crawl of a whole site and return a job_id immediately; a worker runs the crawl and the pages count against the account's rolling 30-day page budget. Use it only when the user asks to crawl or audit a site, or names a number of pages; a request to check a single URL, even a homepage, is check_page, and never start a crawl alongside check_page unasked. Pass the max_pages the user named. One ","read_only":false}],"server_info":{"name":"bseoa-hosted","title":"Black SEO Analyzer","version":"26.11.18","description":"Technical SEO audits run on our servers: crawl a site, then query its issues, pages and the changes between crawls.","icons":[{"src":"https://www.blackseoanalyzer.com/static/images/black-seo-analyzer.png","mimeType":"image/png","sizes":["1024x1024"]},{"src":"https://www.blackseoanalyzer.com/static/images/black-seo-analyzer.svg","mimeType":"image/svg+xml","sizes":["any"]}],"websiteUrl":"https://www.blackseoanalyzer.com"},"category":"web-search","tags":["marketing","project","analytics"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-07","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-sethblack-bseoa/"}