{"_id":"@ashpfeif12/agentweb","name":"@ashpfeif12/agentweb","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@ashpfeif12/agentweb","version":"0.1.0","description":"Make the web agent-ready. Open spec, scorer, and MCP generator for the agent-driven web.","main":"cli.ts","bin":{"agentweb":"cli.ts"},"scripts":{"build":"cd packages/spec && npx tsc && cd ../.. && cd packages/scorer && npx tsc && cd ../.. && cd packages/generator && npx tsc && cd ../..","test":"echo 'tests coming soon'","lint":"echo 'lint coming soon'"},"keywords":["agent","ai","mcp","agent-json","llm","model-context-protocol","web","spec","scorer","generator"],"author":{"name":"ashpfeif12"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/ashpfeif12/agentweb.git"},"homepage":"https://github.com/ashpfeif12/agentweb","engines":{"node":">=20.0.0"},"gitHead":"7b8ba1f5cbd94398c62a943352fa5d30e4c63210","_id":"@ashpfeif12/agentweb@0.1.0","bugs":{"url":"https://github.com/ashpfeif12/agentweb/issues"},"_nodeVersion":"25.9.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-BZW7ouOMmiPOjv4U2AiDdqrzTujiqwkHB6nIRDChtHd5LfvLhtN1OdRgy3hxapiLpw2VinBjygKpB3V/YlYsAg==","shasum":"b9865c862bfdd859ba45962e0c8581678a7376f2","tarball":"https://registry.npmjs.org/@ashpfeif12/agentweb/-/agentweb-0.1.0.tgz","fileCount":41,"unpackedSize":230014,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCq7zBcedlS9Hw04nPZDnsLjx87IjMGfaSlBJ0oDJWYHQIhAK22zCmxMhDmYwkOjJUvqInrb+yX/DeCa8859xhVEjuZ"}]},"_npmUser":{"name":"ashpfeif12","email":"ashpfeif12@gmail.com"},"directories":{},"maintainers":[{"name":"ashpfeif12","email":"ashpfeif12@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agentweb_0.1.0_1776439034395_0.07534950674201979"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-17T15:17:14.322Z","0.1.0":"2026-04-17T15:17:14.533Z","modified":"2026-04-17T15:17:14.768Z"},"maintainers":[{"name":"ashpfeif12","email":"ashpfeif12@gmail.com"}],"description":"Make the web agent-ready. Open spec, scorer, and MCP generator for the agent-driven web.","homepage":"https://github.com/ashpfeif12/agentweb","keywords":["agent","ai","mcp","agent-json","llm","model-context-protocol","web","spec","scorer","generator"],"repository":{"type":"git","url":"git+https://github.com/ashpfeif12/agentweb.git"},"author":{"name":"ashpfeif12"},"bugs":{"url":"https://github.com/ashpfeif12/agentweb/issues"},"license":"MIT","readme":"# 🌐 AgentWeb\n\n**Make the web agent-ready.**\n\nAgentWeb is an open platform for bridging the browser-centric web and the emerging agent-driven web. It provides a spec, tools, and infrastructure so AI agents can discover, query, and transact with any website or service.\n\n```bash\n# Score any site's agent readiness in 30 seconds\nnpx agentweb score https://yoursite.com\n\n# Generate an MCP server from your existing API\nnpx agentweb generate --from openapi.yaml\n```\n\n## The Problem\n\nThe web was built for browsers. AI agents are the next consumer — but they can't discover what your site does, what actions are available, or how to interact with it. There's no `robots.txt` for agents. No structured way to say \"here's what I offer and how to use it.\"\n\n**Result:** Every agent integration is bespoke. Every brand is invisible to agents. The infrastructure gap is massive.\n\n## The Solution: Five Layers\n\n| Layer | What | Type |\n|-------|------|------|\n| **agent.json** | Open spec describing what your site offers to agents | 🟢 Open Source |\n| **MCP Generator** | Auto-generate MCP servers from existing APIs | 🟢 Open Source |\n| **Agent Middleware** | Proxy layer making any site agent-consumable | 🔵 Commercial |\n| **Agent Commerce** | Structured catalogs & policies for agent negotiation | 🔵 Commercial |\n| **Agent SEO** | Analytics for how agents discover your brand | 🔵 Commercial |\n\nOpen source bottom creates adoption. Commercial top solves enterprise problems.\n\n---\n\n## 📋 agent.json — The Spec\n\nDrop an `agent.json` at your domain root. It tells agents what you do and how to interact:\n\n```json\n{\n  \"name\": \"Acme Fashion\",\n  \"version\": \"1.0.0\",\n  \"spec_version\": \"1.0\",\n  \"description\": \"Premium fashion retailer — 2,000+ products across women's and men's collections\",\n  \"capabilities\": [\n    {\n      \"name\": \"search_products\",\n      \"description\": \"Find products by category, color, size, price range, or occasion\",\n      \"type\": \"query\"\n    },\n    {\n      \"name\": \"place_order\",\n      \"description\": \"Add items to cart and complete purchase\",\n      \"type\": \"action\"\n    }\n  ],\n  \"authentication\": {\n    \"type\": \"oauth2\",\n    \"authorization_url\": \"https://acmefashion.com/oauth/authorize\",\n    \"scopes\": [\"read_catalog\", \"place_orders\"]\n  },\n  \"policies\": {\n    \"rate_limit\": \"100/minute\",\n    \"returns\": \"30-day no-questions-asked\",\n    \"data_handling\": \"no_training_on_interactions\"\n  },\n  \"brand_voice\": {\n    \"tone\": \"warm, knowledgeable, never pushy\",\n    \"prohibited\": [\"competitor comparisons\", \"unauthorized discounts\"]\n  },\n  \"endpoints\": {\n    \"mcp\": \"https://mcp.acmefashion.com/sse\",\n    \"rest\": \"https://api.acmefashion.com/v2\",\n    \"docs\": \"https://developers.acmefashion.com\"\n  }\n}\n```\n\n[📖 Full spec documentation →](./packages/spec/README.md)\n\n---\n\n## 📊 Readiness Scorer\n\nScore any website on agent readiness (0–100):\n\n```bash\nnpx agentweb score https://example.com\n```\n\n```\n┌─────────────────────────────────────────┐\n│  Agent Readiness Report: example.com    │\n├─────────────────────────────────────────┤\n│  Discovery    ██████░░░░░░  14/25       │\n│  Structure    ████████░░░░  18/25       │\n│  Actions      ██░░░░░░░░░░   6/25      │\n│  Policies     █░░░░░░░░░░░   4/25      │\n├─────────────────────────────────────────┤\n│  TOTAL SCORE          42/100            │\n│                                         │\n│  Top recommendations:                   │\n│  1. Add agent.json manifest             │\n│  2. Define action schemas               │\n│  3. Add machine-readable policies       │\n└─────────────────────────────────────────┘\n```\n\n[📖 Scorer documentation →](./packages/scorer/README.md)\n\n---\n\n## ⚡ MCP Server Generator\n\nGenerate a fully functional MCP server from your existing API:\n\n```bash\n# From OpenAPI spec\nnpx agentweb generate --from openapi.yaml --output ./my-mcp-server\n\n# From GraphQL schema\nnpx agentweb generate --from schema.graphql --output ./my-mcp-server\n\n# From a live website (experimental)\nnpx agentweb generate --from https://example.com --output ./my-mcp-server\n```\n\nOutputs a complete, deployable package: MCP server code, Dockerfile, agent.json, tests, and README.\n\n[📖 Generator documentation →](./packages/generator/README.md)\n\n---\n\n## 🏗 Project Structure\n\n```\nagentweb/\n├── packages/\n│   ├── spec/          # agent.json JSON Schema + TypeScript types + validation\n│   ├── scorer/        # CLI readiness scorer\n│   └── generator/     # API → MCP server generator\n├── examples/          # Example agent.json files by industry\n├── apps/\n│   └── docs/          # Documentation site\n└── .github/\n    └── workflows/     # CI/CD\n```\n\n## Contributing\n\nWe welcome contributions! The spec is designed to evolve with community input.\n\n- 🐛 **Bug reports**: [Open an issue](https://github.com/agentweb/agentweb/issues)\n- 💡 **Spec proposals**: [Start a discussion](https://github.com/agentweb/agentweb/discussions)\n- 🔧 **Code contributions**: See [CONTRIBUTING.md](./CONTRIBUTING.md)\n\n## License\n\n- `packages/spec` and `packages/scorer` and `packages/generator`: MIT\n- Commercial products: Proprietary\n\n---\n\n<p align=\"center\">\n  <strong>The spec is the wedge. The platform is the business. The timing is now.</strong>\n</p>\n","readmeFilename":"README.md","_rev":"1-08da731f6171125c89435b42e6134554"}