AI Readiness

io.github.epistemedeus由 GitHub 账号 epistemedeus 发布v1.1.3更新于 Oct 24, 2026

Check if a website is visible to AI search (ChatGPT, Perplexity, Claude) and get per-gap fixes.

发布方自己的服务:SameDayDesk agent tools

概览

AI 生成的概览

检查网站是否可被 AI 搜索引擎抓取且结构良好,返回评分、等级以及每项缺口的修复建议。

可以做什么
提供两个工具:check_ai_readiness(url) 返回 0-100 分、字母等级以及每项未通过检查的具体修复建议;generate_ai_readiness_fixes(url) 生成起步用的 Organization 与 FAQPage JSON-LD,以及便于 AI 爬虫抓取的 robots.txt。检查项包括 robots.txt 中的 AI 爬虫访问权限、JSON-LD 结构化数据、标题与元描述、Open Graph 标签、XML 站点地图和 llms.txt。它通过 stdio 在本地运行,也可作为命令行工具或在 CI 中使用。
适用场景
适合让助手审查网站在 AI 搜索引用方面的技术资格,或直接起草结构化数据与 robots.txt 修复内容。适用于站点所有者、SEO 与营销工作,以及部署前检查。
运行要求
需要 Node.js 18 或更高版本;该服务器作为本地 stdio 进程运行,通常用 npx 启动。未声明需要账号、注册、API 密钥或环境变量。需要网络访问以抓取目标网站。
安装前请注意
该服务器会抓取你提供的网址,请只对你有权检查的站点使用。生成的 robots.txt 与 JSON-LD 是起步文件,一旦应用会改变爬虫对站点的处理方式,部署前请先审阅。README 还推广付费产品与服务,这些与免费工具是分开的。

安装

在 SourceWeft 中

  1. 打开 控制台中的 AI Readiness,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

ai-readiness

Is your website visible to AI search? A tiny, dependency-free CLI that checks whether ChatGPT, Perplexity, Claude, and Google AI can crawl and understand your site, and tells you exactly what to fix.

bash
npx github:epistemedeus/ai-readiness yoursite.com

No install, no signup, no dependencies. Node 18+.

Prefer a browser? Run the same check (no install) at samedaydesk.com/tools/ai-readiness.


📦 Want the fixes done for you? AI Search Readiness Kit: $9

The checker tells you what to fix. This kit gives you everything to fix it, ready to paste:

  • Copy-paste robots.txt (welcomes every AI crawler), Organization + WebSite + FAQPage JSON-LD, title/meta/Open Graph templates, and an XML sitemap
  • The 7-fix priority checklist in order of impact
  • The full benchmark behind the dataset below
  • Delivered instantly after checkout, no signup

→ Get the AI Search Readiness Kit ($9) · Prefer a done-for-you audit of your site? See samedaydesk.com.

Dataset: 136 companies scored for AI-search readiness (June 2026)

We ran this checker against the homepages of 136 well-known companies across 7 industries and published the full results. Open data, free to use with attribution.

Average score by industry (lower = harder for AI search to read):

IndustryAvg scoren
Marketing agencies9224
SaaS8824
Dev tools8617
E-commerce8519
AI startups8325
Fintech7416
Healthtech6311

Notable findings: Healthtech is the least AI-search-ready industry (avg 63). Klarna scored an F (38); GitHub, Chime, Ramp, Gusto, Ro, Hims and Zocdoc each scored a D. Even some AI companies struggle. Perplexity scored a C and LlamaIndex a D. Most gaps are the same and entirely fixable: JavaScript-only homepages, missing JSON-LD structured data, and no sitemap.

Per-industry write-ups: SaaS · e-commerce · marketing agencies · AI startups · healthtech.

Why this matters

AI search is becoming how people find things, and AI answers are pulled from a small set of pages that are crawlable and well-structured. If GPTBot is blocked in your robots.txt, or your pages have no structured data, you can be invisible in AI answers no matter how good your site looks to humans. This tool checks the technical fundamentals that decide whether you're even eligible to be cited.

What it checks

CheckWhy it matters
AI crawler accessWhether GPTBot, OAI-SearchBot, ClaudeBot, PerplexityBot, Google-Extended, CCBot, Bingbot are allowed in robots.txt. Blocked = invisible.
Structured data (JSON-LD)AI engines use JSON-LD (Organization, FAQPage, Article) to classify and quote your content.
Title & meta descriptionPresent and well-sized, so engines have a clean summary to work with.
Open Graph tagsRicher machine-readable context and clean link previews.
XML sitemapHelps engines discover your pages; submit it in Bing Webmaster Tools (ChatGPT Search reads the Bing index).
llms.txtFlagged as cheap hygiene only. Honest note: it has no proven effect on AI citations yet, so don't let anyone sell it to you as a ranking boost.

You get a 0-100 score, a letter grade, and a concrete fix for every failing check.

Example

$ npx github:epistemedeus/ai-readiness example.com
AI Readiness  https://example.com/Score 72/100  Grade B
  PASS  AI crawler access  No AI crawler blocked.  FAIL  Structured data (JSON-LD)  None found.        fix: Add Organization + FAQPage + Article JSON-LD.  PASS  Title & meta description  title 41 chars, description 132 chars  WARN  Open Graph tags  2 og: tags        fix: Add og:title, og:description, og:image, og:url.  PASS  XML sitemap  found  WARN  llms.txt  none (minor: no proven citation effect)

JSON output for scripting: npx github:epistemedeus/ai-readiness yoursite.com --json

Use as an MCP server

Add the checker to any Model Context Protocol client (Claude Desktop, Cursor, Cline, etc.) so you can ask your AI assistant "is my site visible to AI search?" and get a scored report inline. Dependency-free, runs over stdio.

json
{  "mcpServers": {    "ai-readiness": {      "command": "npx",      "args": ["-y", "github:epistemedeus/ai-readiness", "mcp"]    }  }}

It exposes two tools:

  • check_ai_readiness(url): returns the score, grade, and a specific fix for each gap.
  • generate_ai_readiness_fixes(url): generates starter Organization + FAQPage JSON-LD (pre-filled from the site) and an AI-crawler-friendly robots.txt.

This standalone package is the two-tool local MCP server. Use the npx stdio config above (npx -y github:epistemedeus/ai-readiness mcp, or node mcp.js). http.js is a minimal stateless custom JSON-RPC-over-HTTP POST adapter (POST /mcp); it is not MCP Streamable HTTP, not a production remote MCP transport, and ordinary Streamable HTTP clients cannot use it as-is. There is no hosted remote MCP URL for this package.

Use in CI (GitHub Action)

Fail-fast on AI-search regressions by checking a URL on every deploy:

yaml
- uses: epistemedeus/ai-readiness@v1  with:    url: https://yoursite.com

The deep version

This CLI checks the technical basics. The questions it can't answer from your markup: do ChatGPT, Perplexity, and Google AI actually cite you for the queries your buyers type? How do you compare to named competitors? What's the highest-ROI fix first?

That's the AI-Search Visibility Audit from SameDayDesk: real citation testing across engines, a competitor benchmark, and a prioritized fix list as a PDF and web report, delivered same day. → samedaydesk.com

Need a custom MCP server?

Like how this one is built: dependency-free, stdio plus a custom JSON-RPC-over-HTTP POST adapter, published to the MCP registry, two focused tools? We build MCP servers for your API or product the same way. (Curious how? Read the guide: How to build a dependency-free MCP server.)

Custom MCP Server: $349, delivered fast. You get a working server (stdio + optional hosted remote), wired to your API, with the registry/manifest setup done. → get one built (or buy directly).

Guides

Free, in-depth guides on getting your site read and cited by AI search:

License

MIT © SameDayDesk

来源:README.md,提交 243749a

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.1.3最新Sep 16, 2026

评分

已满足适用检查项的 50%

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

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Samedaydesk 集成