GenReady

io.github.odb366由 GitHub 账号 odb366 发布v1.2.5更新于 Oct 29, 2026

扫描网站,评估其对AI搜索和智能体的就绪程度,然后为你的智能体获取一份修复清单。

AI 翻译由 AI 模型根据下方的原文描述翻译,可能有误。

原文描述

Scan a website for AI search and agent readiness, then get a fix checklist for your agent.

已验证Streamable HTTP可网页运行网页搜索与抓取AI 与机器学习

概览

GenReady 的托管 MCP 服务(genready.ai);需要 OAuth 登录或 API 密钥;Streamable HTTP;12 个工具。

暂无 AI 概览:以下信息来自注册中心条目和服务本身。

端点
genready.ai
最近检查

安装

在 SourceWeft 中

  1. 打开 控制台中的 GenReady,将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储,绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.odb366%2Fgenready/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "genready": {
      "type": "http",
      "url": "https://genready.ai/mcp"
    }
  }
}

README

@genready/mcp-server

Connect GenReady to your AI assistant or coding agent. Scan any page for readiness to be cited by AI search engines and used by AI agents, then hand the fix checklist straight to your agent.

1. Get an API key

Create one at genready.ai/api-keys. To read site-wide fix plans, enable Read site data (domain:read) when you create it.

2. Connect

Remote (recommended, nothing to install)

Any client that supports remote MCP servers over Streamable HTTP can connect directly:

  • URL: https://genready.ai/mcp
  • Header: Authorization: Bearer gr_live_your_key_here

Claude Code:

bash
claude mcp add --transport http genready https://genready.ai/mcp \  --header "Authorization: Bearer gr_live_your_key_here"

Cursor (.cursor/mcp.json):

json
{  "mcpServers": {    "genready": {      "url": "https://genready.ai/mcp",      "headers": { "Authorization": "Bearer gr_live_your_key_here" }    }  }}

Local command (stdio)

For clients that only launch local commands, such as Claude Desktop:

json
{  "mcpServers": {    "genready": {      "command": "npx",      "args": ["-y", "@genready/mcp-server"],      "env": { "GENREADY_API_KEY": "gr_live_your_key_here" }    }  }}

This package forwards to the hosted endpoint, so both options expose the same tools.

3. Ask

Scan https://example.com for AI readiness and fix what you can in this repo.

Tools

ToolWhat it doesCredits
analyze_websiteScan a URL. Returns scores and the fix checklist. scope: full, content, crawlability.1 per scan
get_reportRead a stored report by ID, including its fix checklist.Free
check_statusProgress of a scan that did not finish, or was started with wait: false.Free
list_reportsYour past reports, with filters for URL and status.Free
get_findingsThe fix list for a page or a site, with stable ids.Free
verify_findingsRe-check findings against the live site after you deploy a fix (Pro and Agency).Free
update_findingRecord that a finding is fixed, pending, or ignored.Free
get_artifactGenerate a robots.txt, llms.txt or JSON-LD file that fixes a finding.Free
start_site_analysisScan a whole site (needs site:analyze). Capped at 25 pages over OAuth.1 per page
get_usagePlan, credits used and remaining.Free
list_domainsYour monitored domains (needs domain:read).Free
get_fix_planRanked site-wide fixes from a domain's latest site analysis (needs domain:read).Free

The fix checklist is included on Pro and Agency plans. On other plans, reports say it is locked.

Environment variables (stdio)

VariableRequiredDescription
GENREADY_API_KEYYesYour API key (starts with gr_live_)
GENREADY_MCP_URLNoHosted MCP endpoint (default https://genready.ai/mcp)

Links

Support and contributing

  • Found a bug or a wrong tool description? Open an issue. Include the tool name, what you asked, and the error text.
  • Questions about your account or plan: genready.ai/support.
  • This repository is a published copy of the MCP server that lives in the GenReady monorepo. See CONTRIBUTING.md before you open a pull request.

来源:README.md,提交 163b1e4

工具

12

analyze_website

Scan a page for AI readiness

Scan one URL for readiness to be cited by AI search engines (ChatGPT, Perplexity, Google AI Overviews) and used by AI agents. Returns scores and the fix checklist: prioritized problems with concrete fixes. Uses one API credit per call, so re-scan only after deploying a change. scope='content' or 'crawlability' runs a narrower, faster scan.

输入参数url必填waitscope

get_report

Read a page report

Read a stored page report by report ID: the scores and the prioritized fix checklist, with a note on any fixes locked on the account's plan. Use it when you already have a report ID (from analyze_website, check_status or list_reports). It reads saved data and never rescans, so it shows the page as it was when scanned; call analyze_website to see changes. Returns an error if the ID is unknown or belongs to another account. Free: does not use a credit.

输入参数report_id必填

get_findings

List findings for a page or site

Findings are the fix list keyed by rule: each carries a stable id that survives re-scans, a policy saying whether an agent may apply the fix unattended ('apply') or should only propose it, and whether a fix can be confirmed by one cheap fetch. Pass exactly one of report_id (the findings of one page) or domain_id (the findings of the latest site analysis), otherwise it returns an error. Use get_report instead if you only need scores. Pass the ids it returns to verify_findings, update_finding and get_artifact. Read-only. Free: does not use a credit.

输入参数domain_idreport_id

verify_findings

Check whether fixes landed

Re-check findings after deploying a fix. Fetches the live page once per check, with no analysis and no credit, and answers verified, still_failing or unverifiable per finding. Use this instead of re-running analyze_website. Pass exactly one of report_id, domain_id or site_analysis_id, and optionally the finding ids to check. Included with Pro and Agency.

输入参数domain_idreport_idfinding_idssite_analysis_id

get_artifact

Get a file to commit

Generate a file that fixes a deterministic finding: 'robots_txt' (unblocks AI crawlers while leaving other rules alone), 'llms_txt' (lists the site's real pages) or 'jsonld' (a script block for one page). Anything we did not measure comes back as TODO rather than a guess, so check needsHumanInput before committing. Pass exactly one of report_id or domain_id. Free: does not use a credit.

输入参数kind必填domain_idreport_id

update_finding

Record what you did about a finding

Remember a decision so a later session does not redo it. 'fixed_pending' means you changed something and it is not deployed or confirmed yet; 'ignored' silences a finding and requires a reason; 'open' undoes either. You cannot set 'verified': that is earned by calling verify_findings against the live site. Free: does not use a credit.

输入参数reasonstatus必填finding_id必填ignored_until

start_site_analysis

Scan a whole site

Start a site-wide analysis and let it pick its own pages: the homepage first, then the sections covering the most pages, since a template problem there repeats across the site. Spends one credit per page scanned, so it can cost a lot at once; the plan cap and the credits left both apply and the smaller wins. When connected through OAuth (for example from Claude), a run scans at most 25 pages unless you pass max_pages. Returns immediately. Over an API key it requires the Start site analyses (site:analyze) scope.

输入参数excludeincludedomain_id必填max_pages

check_status

Check scan progress

Check the progress of one page scan by report ID. Returns its status (queued, processing, complete or failed), a progress percentage when known, and which tool to call next. Use it when analyze_website returned a report ID before the scan finished, or after you started a scan with wait=false. Poll every few seconds, not in a tight loop. For a whole-site run started with start_site_analysis, call get_fix_plan instead. Returns an error if the report ID is unknown. Read-only. Free: does not use a credit.

输入参数report_id必填

list_reports

List reports

List the page reports this account has generated, newest first. Each entry has the report ID, URL, overall score, status and creation time. Use it to find a report ID for get_report or get_findings, or to see which pages were already scanned before spending a credit on analyze_website. Filter by URL or status; results come in pages of up to 100, so check the page count at the top of the output and request the next page for more. Read-only. Free: does not use a credit. Returns 'No reports found.' when nothing matches.

输入参数urlpagelimitstatus

get_usage

Check plan usage

Check the plan, API credits used and remaining, and the billing period. Call before a batch of scans.

无需输入参数。

list_domains

List monitored domains

List the account's monitored domains and their IDs, for use with get_fix_plan. Requires an API key with the domain:read scope.

无需输入参数。

get_fix_plan

Read a site-wide fix plan

Read the ranked, site-wide fix plan from a domain's latest site analysis: each action says how many pages it affects, how to fix it, and which URLs to verify on. Pass exactly one of domain_id (latest run) or site_analysis_id (a specific run). Free: does not use a credit. Requires the domain:read scope.

输入参数domain_idsite_analysis_id

版本历史

3
  1. v1.2.5最新Oct 20, 2026
  2. v1.2.2Oct 18, 2026
  3. v1.2.1Oct 18, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分