{
  "markdown": "# aigentify\n\naigentify audits a product directory or live URL for agent-native readiness. It also creates the public artifacts that agents can use.\n\n## Install\n\n```sh\nnpm install aigentify\n```\n\n## Three faces\n\nUse the library in JavaScript or TypeScript:\n\n```ts\nimport { auditTarget, generate } from 'aigentify';\n\nconst report = await auditTarget('.');\nconst instructions = generate('agents-md', {\n  name: 'Example product',\n  description: 'A product with a clear agent interface.',\n  repository: 'https://github.com/example/product',\n});\n```\n\nUse the CLI:\n\n```sh\nnpx aigentify audit .\nnpx aigentify gen agents-md\nnpx aigentify gen server-json --out server.json\n```\n\nUse the MCP server with an MCP client:\n\n```sh\nnpx aigentify-mcp\n```\n\nThe MCP server exposes `audit` with `{ target }` and `gen` with `{ artifact, params }`.\n\n## Commands\n\n- `aigentify audit [target]` checks a directory or URL. The default target is `.`.\n- `aigentify init` writes starter `AGENTS.md` and `server.json` files. Existing files stay unchanged.\n- `aigentify gen <artifact>` prints an artifact or writes it with `--out`.\n- `aigentify mcp` starts the stdio MCP server.\n\nArtifacts are `agents-md`, `server-json`, `offer`, and `agents-route`.\n\n## Checks\n\n`audit` scores these signals. The core signals work for a directory or a URL; the\nweb signals are only meaningful for a served URL and are marked `na` otherwise.\n\nCore: `agents-md`, `agents-md-public-safe`, `server-json`, `mcp`, `offer-jsonld`,\n`honest-offer`, `llms-txt`, `sitemap`.\n\nWeb (URL targets): `well-known-agent`, `openapi`, `agents-page`, `soft-404`\n(unknown paths must return a real 404, not a 200 app shell), `markdown-negotiation`\n(serve `text/markdown` on `Accept: text/markdown` with `Vary: Accept`),\n`content-without-js` (an `<h1>` and 500+ characters without JS), `org-schema`\n(Organization JSON-LD with `contactPoint` and `address`), `crawler-reachable`\n(agent User-Agents can reach the homepage), and `rate-limit-headers` (standard\n`RateLimit-*` headers), plus `auth-md`, `api-catalog` (RFC 9727),\n`agent-card-a2a` (A2A), `link-headers` (RFC 8288), `markdown-alt`, plus **external-discovery** checks that query third-party registries — `ai-plugin`, `wikidata` (P856 official-website match), `npm-package`, and `mcp-registry`.\n\n## Configuration\n\nAdd an optional `aigentify.config.ts`, `aigentify.config.js`, or `aigentify.config.mjs` file. Export `defineConfig(...)` data as the default export or as `aigentifyConfig`.\n\n```ts\nimport { defineConfig } from 'aigentify';\n\nexport default defineConfig({\n  name: 'Example product',\n  description: 'A product with a clear agent interface.',\n  repository: 'https://github.com/example/product',\n  npmPackage: 'example-product',\n  offer: { name: 'Access', price: 0, priceCurrency: 'USD' },\n});\n```\n\n## License\n\nMIT\n",
  "bytes": 2803,
  "sha": "855022503f95457b04944b839eade393d8360e93a317c086ef44c35864e05f4a",
  "repo_slug": "pooriaarab/aigentify",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_pooriaarab_aigentify_8e333b05/readme"
}