aigentify

aigentify

软件包和 API 类型 · 快速入门 · 配置

aigentify 是一款开源的 Agent 就绪度审计工具，面向维护产品目录和公共网站的开发者。 它会返回评分、各项检查结果和可执行的改进建议。 其 TypeScript 库、命令行界面（CLI）和模型上下文协议（MCP）服务还可生成公开的内容文本。

安装

npm install aigentify

需要 Node.js 20 或更高版本。此软件包有五个直接运行时依赖项，并包含 TypeScript 声明。 价格：0 美元。

运行首次审计

在现有产品目录中运行此命令：

npx aigentify audit .

对目录进行审计无需环境变量、凭据或 .env 加载器。 报告以 .: <score>/100 开头，列出各项检查状态，并以 Gaps: 结尾。 低分表示审计已完成，并不代表命令执行失败。

使用产品信息生成公开指南：

npx aigentify gen agents-md --name Example --description 'A product API.' --repository https://example.com --price 0 --price-currency USD --out agents.md

成功后会创建 agents.md。发布前，请检查其中的占位内容和产品专属说明。

import { auditTarget, generate } from 'aigentify';

const report = await auditTarget('.');
console.log(report.score, report.gaps);
console.log(generate('offer', {
  name: 'Example',
  description: 'A product API.',
  repository: 'https://example.com',
  offer: { price: 0, priceCurrency: 'USD' },
}));

将其保存为 audit.mjs，然后运行 node audit.mjs，即可打印评分和结构化优惠信息。

工作原理

Directory files or URL responses
              |
       Snapshot and checks
              |
       Score + ordered gaps
              |
  Fix product facts -> generate text -> publish -> audit again

URL 审计会获取发现端点并查询外部注册表。目录审计会检查文件，但不会运行应用程序。

存在的原因

开发者需要在进行常规网站检查的同时，检查 Agent 发现文件。 Lighthouse 用于审计 Web 质量；axe-core 用于检查无障碍性。 aigentify 专注于面向 Agent 的清单、公开说明、优惠信息和发现证据。

对比

范围核查日期为 2026-10-14。这些工具满足相邻领域的审计需求。

检查范围	aigentify	Lighthouse	axe-core
主要目标	Agent 就绪度	网页质量	无障碍性
此处的输入	目录或 URL	网页	基于 HTML 的界面
此处生成的输出	Agent 内容文本	审计报告	无障碍性结果

覆盖范围

此实现定义了 27 项审计检查、六个生成器和三项外部注册表探测。 这些是通过源码核查确认的功能，并不意味着每个目标都能通过这些检查。 此次改写未进行基于凭据的平台验证。

界面或集成	状态	范围
AGENTS.md、MCP 发现、server.json	已实现	存在性、字段和公开安全性启发式检查
Schema.org 优惠信息	已实现	JSON-LD 检测和紧迫性用语检查
llms.txt 和 sitemap.xml	已实现	可用性
OpenAPI、Agent 清单、/agents	已实现	URL 发现检查
个人 Agent 协议（Poppy）	已实现	Draft 0.1 验证；仅用于发现的生成器
HTTP 发现和爬虫响应	已实现	Markdown、链接、状态、正文、架构、速率限制标头
身份验证指南、API 目录、Agent2Agent 卡片	已实现	文档结构或可用性
AI 插件清单	已实现	名称、API 和身份验证字段
Wikidata	已实现	官方网站查询
npm	已实现	软件包搜索以及名称/主页匹配
官方 MCP 注册表	已实现	服务搜索以及名称/主机匹配
Next.js	模板	agents-route --framework next 会打印路由说明

缺少证据或结果不明确时，外部检查会返回警告。 仅适用于 URL 的检查对本地目录会返回 na。

常见用例

1. 软件包维护者在将面向 Agent 的文件发布到 npm 前，审核 Node.js 目录。
2. Next.js 开发者生成 /agents.md 路由说明，然后审核已部署的 URL。
3. MCP 服务作者生成 server-json，并检查其软件包或远程配置。
4. API 团队检查公共 URL 上的 OpenAPI 发现信息、身份验证指南和 Agent2Agent 卡片。
5. 产品开发者检查 Wikidata、npm 和 Official MCP Registry 的发现证据。

功能

• 目录和 URL 审核会返回评分、检查项和按顺序排列的差距。
• 生成资源会返回文本，不会部署服务。
• JSON 输出支持通过 audit --json 编写脚本。
• 配置会在生成的资源之间共享产品信息。

运行时接口

该库导出 auditTarget、formatAuditReport、scoreAuditChecks、defineConfig、defaultConfig 和生成器函数。 在 Node.js 上运行该库；审核会使用文件系统 API。

CLI 命令	行为
audit [target]	默认为 .；--json 输出报告
init	创建 AGENTS.md、server.json 和 auth.md；--force 允许覆盖
gen <artifact>	输出文本；--out 将内容写入文件
mcp	启动 stdio 服务

六种资源名称为 agents-md、server-json、offer、agents-route、auth-md 和 poppy。 agents-route 接受 --framework static 或 --framework next。 使用 npx aigentify-mcp 启动独立服务。 它提供两个工具：audit，参数为 { target }；以及 gen，参数为 { artifact, params }。

配置

创建 aigentify.config.ts、aigentify.config.js 或 aigentify.config.mjs，用于 CLI 生成：

import { defineConfig } from 'aigentify';

export default defineConfig({
  name: 'Example',
  description: 'A product API.',
  repository: 'https://example.com',
  npmPackage: 'example-product',
  offer: { price: 0, priceCurrency: 'USD' },
});

导出默认配置或命名配置 aigentifyConfig。 库和 MCP 生成器可直接接受参数。

交付／行为限制

评分使用加权启发式规则。满分并不能保证与 Agent 兼容、获得良好的搜索排名或被发现。 爬虫检查使用一个 Agent User-Agent，不会测试所有爬虫。 请求超时为 8 秒；注册表故障可能导致发现证据无法得出结论。 审核会抓取文本，但不会执行浏览器 JavaScript。 生成的文件包含默认值和模板，需要审核。 身份验证模板描述 API 密钥行为；它不会实现身份验证。 Poppy 生成器输出的仅是发现数据，不包含经过身份验证的 Agent 或 API 连接。 除非设置 --force，否则 init 会保留现有文件。它不会部署这些文件。

集成指南

• Next.js 路由模板：生成说明，然后自行发布路由。
• MCP stdio 设置：将客户端连接到 aigentify-mcp。
• 共享产品配置：设置名称、URL 和优惠信息。

状态

版本 0.5.0 属于 0.x 版本。接口和检查项可能会变更。 如需支持，请使用 npm 软件包上列出的 GitHub 问题反馈渠道。 此 README 尚未发布公开案例研究。

常见问题

aigentify 会审核什么？

aigentify 会审核本地目录或公共 URL 中体现 Agent 就绪情况的信号。 其报告包含评分、检查项和可执行的差距建议。

哪些集成经过验证？

aigentify 在源代码中实现了 Wikidata、npm 和 Official MCP Registry 探测。 本次改写检查了实现代码，但没有进行实时的凭据验证活动。

aigentify 是否提供托管服务？

aigentify 可在你的 Node.js 进程或 stdio MCP 服务中运行。 你需要自行发布和托管生成的资源。

aigentify 与 Lighthouse 有何不同？

aigentify 检查面向 Agent 的发现信息，并生成资源文本。 Lighthouse 会审核网页质量。

aigentify 与 axe-core 有何不同？

aigentify 会检查 Agent 的就绪情况和公开发现文件。 axe-core 会评估基于 HTML 的界面的无障碍性。

aigentify 需要 API 密钥吗？

aigentify 在审计目录或探测公共注册表时无需 API 密钥。 生成的身份验证指南是适用于你产品的模板。

得分为 100 是否能保证兼容性？

aigentify 评估的是已实现的启发式规则，而非与每个 Agent 的端到端兼容性。 请使用你支持的客户端测试已发布的界面。

aigentify 能自动修复我的网站吗？

aigentify 会生成文本和入门文件。 你需要核实产品信息、实现缺失的功能，并部署更改。

许可证

MIT。