{"_id":"@agentgram/ax-score","_rev":"3-4b4ffd7b0fd6732491a1edc5e81cadee","name":"@agentgram/ax-score","dist-tags":{"latest":"0.3.0"},"versions":{"0.1.0":{"name":"@agentgram/ax-score","version":"0.1.0","keywords":["ax-score","agent-experience","ai","lighthouse","agent-friendly","aeo","llm","audit","cli"],"author":{"name":"AgentGram","email":"hello@agentgram.co"},"license":"MIT","_id":"@agentgram/ax-score@0.1.0","maintainers":[{"name":"iisweetheartii","email":"sachi009955@gmail.com"}],"homepage":"https://github.com/agentgram/ax-score#readme","bugs":{"url":"https://github.com/agentgram/ax-score/issues"},"bin":{"ax-score":"dist/bin/ax-score.js"},"dist":{"shasum":"d08e71e560305bc8a1c5985be65b9b490313600b","tarball":"https://registry.npmjs.org/@agentgram/ax-score/-/ax-score-0.1.0.tgz","fileCount":9,"integrity":"sha512-3FH0kCYEWQqI8BVLz9OBrT8OyPlWvC7P7RedY7R9DA4CdD+RsTH91KjqBjB+YLbvqQ1dQCK4OVPUOspBBwS/Ug==","signatures":[{"sig":"MEUCIGvGe7AP6olVojIfV+W+r0ZVnLKS1xMvH/KgEey+m6EOAiEAlyI8X44xBHG0csRbcuTyNV2AznM7C25K+6XCKpHFr5k=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":45965},"main":"./dist/index.js","type":"module","_from":"file:agentgram-ax-score-0.1.0.tgz","types":"./dist/index.d.ts","engines":{"node":">=20.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsup --watch","lint":"eslint src/","test":"vitest run","build":"tsup","format":"prettier --write \"src/**/*.ts\"","test:watch":"vitest","type-check":"tsc --noEmit"},"_npmUser":{"name":"iisweetheartii","email":"sachi009955@gmail.com"},"_resolved":"/tmp/63286676283793a495638a901cb0ba75/agentgram-ax-score-0.1.0.tgz","_integrity":"sha512-3FH0kCYEWQqI8BVLz9OBrT8OyPlWvC7P7RedY7R9DA4CdD+RsTH91KjqBjB+YLbvqQ1dQCK4OVPUOspBBwS/Ug==","repository":{"url":"git+https://github.com/agentgram/ax-score.git","type":"git"},"_npmVersion":"10.8.2","description":"AX Score - The Lighthouse for AI Agent Experience. Measure how agent-friendly your website or API is.","directories":{},"_nodeVersion":"20.20.0","dependencies":{"ora":"^9.1.0","chalk":"^5.4.1","commander":"^14.0.3"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.6","eslint":"^9.19.0","vitest":"^4.0.18","prettier":"^3.4.2","@eslint/js":"9.39.2","typescript":"^5.9.3","@types/node":"^25.2.0","typescript-eslint":"8.54.0"},"_npmOperationalInternal":{"tmp":"tmp/ax-score_0.1.0_1770307167229_0.36087073079846665","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@agentgram/ax-score","version":"0.2.0","keywords":["ax-score","agent-experience","ai","lighthouse","agent-friendly","aeo","llm","audit","cli"],"author":{"name":"AgentGram","email":"hello@agentgram.co"},"license":"MIT","_id":"@agentgram/ax-score@0.2.0","maintainers":[{"name":"iisweetheartii","email":"sachi009955@gmail.com"}],"homepage":"https://github.com/agentgram/ax-score#readme","bugs":{"url":"https://github.com/agentgram/ax-score/issues"},"bin":{"ax-score":"dist/bin/ax-score.js"},"dist":{"shasum":"b28e322ebffd63061c2cab3d8998aa3d996efbca","tarball":"https://registry.npmjs.org/@agentgram/ax-score/-/ax-score-0.2.0.tgz","fileCount":9,"integrity":"sha512-M05/90CjufZ0rtSxp3U9do7V2XdHq6IZ5bnZeTmx+/Ezb0yUqp/MwklCeEqT/Q4rPKa2cHJtaWfHp1kB9O7X4g==","signatures":[{"sig":"MEYCIQD1hh76Rb5jMCA9BFnwekNnc9R1diPWWldmx2C8lBbRsAIhALBOhNw2fWLxGnZQUsyXhpqel+fK4wxocOt6dU3AFfJ/","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":277666},"main":"./dist/index.js","type":"module","_from":"file:agentgram-ax-score-0.2.0.tgz","types":"./dist/index.d.ts","engines":{"node":">=20.0.0"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"tsup --watch","lint":"eslint src/","test":"vitest run","build":"tsup","format":"prettier --write \"src/**/*.ts\"","test:watch":"vitest","type-check":"tsc --noEmit"},"_npmUser":{"name":"iisweetheartii","email":"sachi009955@gmail.com"},"_resolved":"/tmp/705440e6472bb3c5829f43e3dcf180f3/agentgram-ax-score-0.2.0.tgz","_integrity":"sha512-M05/90CjufZ0rtSxp3U9do7V2XdHq6IZ5bnZeTmx+/Ezb0yUqp/MwklCeEqT/Q4rPKa2cHJtaWfHp1kB9O7X4g==","repository":{"url":"git+https://github.com/agentgram/ax-score.git","type":"git"},"_npmVersion":"10.8.2","description":"AX Score - The Lighthouse for AI Agent Experience. Measure how agent-friendly your website or API is.","directories":{},"_nodeVersion":"20.20.0","dependencies":{"ora":"^9.1.0","chalk":"^5.4.1","commander":"^14.0.3"},"_hasShrinkwrap":false,"devDependencies":{"tsup":"^8.3.6","eslint":"^9.19.0","vitest":"^4.0.18","prettier":"^3.4.2","@eslint/js":"9.39.2","typescript":"^5.9.3","@types/node":"^25.2.0","typescript-eslint":"8.54.0"},"_npmOperationalInternal":{"tmp":"tmp/ax-score_0.2.0_1771512824027_0.55439952272787","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@agentgram/ax-score","version":"0.3.0","description":"AX Score - The Lighthouse for AI Agent Experience. Measure how agent-friendly your website or API is.","type":"module","main":"./dist/index.js","types":"./dist/index.d.ts","bin":{"ax-score":"dist/bin/ax-score.js"},"exports":{".":{"import":"./dist/index.js","types":"./dist/index.d.ts"}},"dependencies":{"chalk":"^5.4.1","commander":"^14.0.3","ora":"^9.1.0"},"devDependencies":{"@eslint/js":"9.39.2","@types/node":"^25.2.0","eslint":"^9.19.0","prettier":"^3.4.2","tsup":"^8.3.6","typescript":"^5.9.3","typescript-eslint":"8.54.0","vitest":"^4.0.18"},"engines":{"node":">=20.0.0"},"repository":{"type":"git","url":"git+https://github.com/agentgram/ax-score.git"},"homepage":"https://github.com/agentgram/ax-score#readme","bugs":{"url":"https://github.com/agentgram/ax-score/issues"},"keywords":["ax-score","agent-experience","ai","lighthouse","agent-friendly","aeo","llm","audit","cli"],"author":{"name":"AgentGram","email":"hello@agentgram.co"},"license":"MIT","scripts":{"build":"tsup","dev":"tsup --watch","lint":"eslint src/","type-check":"tsc --noEmit","test":"vitest run","test:watch":"vitest","format":"prettier --write \"src/**/*.ts\""},"_id":"@agentgram/ax-score@0.3.0","_integrity":"sha512-554Qw6so5P/NzfejnZ21TozBIgsimGAqg2Lisdxm5W1P5Rf9PBDtcNQ86y9shA6WcC3qen4U4cbc08jk24Sgkg==","_resolved":"/tmp/e7e579bfdd890f75d1f4737c63e7d652/agentgram-ax-score-0.3.0.tgz","_from":"file:agentgram-ax-score-0.3.0.tgz","_nodeVersion":"20.20.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-554Qw6so5P/NzfejnZ21TozBIgsimGAqg2Lisdxm5W1P5Rf9PBDtcNQ86y9shA6WcC3qen4U4cbc08jk24Sgkg==","shasum":"71aa320e0f40ae7b2a5494e0cc368695a17da80b","tarball":"https://registry.npmjs.org/@agentgram/ax-score/-/ax-score-0.3.0.tgz","fileCount":9,"unpackedSize":291408,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHy3fP+98cCqcnPMPkQNI/fkRBGSXK0g74S7waM0hBkbAiEAsOfFMplHZihDYgN/nyywnnHpg6uWJT19APKOaey/myg="}]},"_npmUser":{"name":"iisweetheartii","email":"sachi009955@gmail.com"},"directories":{},"maintainers":[{"name":"iisweetheartii","email":"sachi009955@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ax-score_0.3.0_1771517268748_0.5275825235237743"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-05T15:59:27.162Z","modified":"2026-02-19T16:07:49.027Z","0.1.0":"2026-02-05T15:59:27.375Z","0.2.0":"2026-02-19T14:53:44.169Z","0.3.0":"2026-02-19T16:07:48.893Z"},"bugs":{"url":"https://github.com/agentgram/ax-score/issues"},"author":{"name":"AgentGram","email":"hello@agentgram.co"},"license":"MIT","homepage":"https://github.com/agentgram/ax-score#readme","keywords":["ax-score","agent-experience","ai","lighthouse","agent-friendly","aeo","llm","audit","cli"],"repository":{"type":"git","url":"git+https://github.com/agentgram/ax-score.git"},"description":"AX Score - The Lighthouse for AI Agent Experience. Measure how agent-friendly your website or API is.","maintainers":[{"name":"iisweetheartii","email":"sachi009955@gmail.com"}],"readme":"# AX Score — The Lighthouse for AI Agents\n\n[![npm version](https://img.shields.io/npm/v/@agentgram/ax-score.svg)](https://www.npmjs.com/package/@agentgram/ax-score)\n[![Build Status](https://github.com/agentgram/ax-score/workflows/CI/badge.svg)](https://github.com/agentgram/ax-score/actions)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nAX Score is an open-source CLI tool and library that measures how \"agent-friendly\" a website or API is.\n\n---\n\n## 🚀 Quick Demo\n\n```bash\n$ npx @agentgram/ax-score https://agentgram.co\n\nGathering data... [DONE]\nRunning 24 audits... [DONE]\n\nAX Score for https://agentgram.co\n---------------------------------\nOverall Score: 94/100\n\nCategories:\n- Discovery: 100/100\n- API Quality: 92/100\n- Structured Data: 100/100\n- Auth & Onboarding: 85/100\n- Error Handling: 100/100\n- Documentation: 100/100\n\nTop Suggestions:\n- [Auth] Implement Ed25519 cryptographic signatures for higher security.\n- [API] Add X-RateLimit-Reset headers to all responses.\n```\n\n---\n\n## 📦 Installation\n\n### CLI Usage\n\nInstall globally:\n\n```bash\nnpm install -g @agentgram/ax-score\n```\n\nOr run directly with npx:\n\n```bash\nnpx @agentgram/ax-score https://example.com\n```\n\n### Programmatic Usage\n\n```typescript\nimport { runAudit } from '@agentgram/ax-score';\n\nconst results = await runAudit('https://example.com');\nconsole.log(`Score: ${results.score}`);\n```\n\n---\n\n## 📊 AX Categories\n\n| Category          | Weight | Description                                                              |\n| ----------------- | ------ | ------------------------------------------------------------------------ |\n| Discovery         | 25%    | Can agents find your API and documentation? (`llms.txt`, `openapi.json`) |\n| API Quality       | 25%    | Is the API consistent and easy to use programmatically?                  |\n| Structured Data   | 20%    | Does the site provide JSON-LD or other machine-readable metadata?        |\n| Auth & Onboarding | 15%    | Can agents register and authenticate without human intervention?         |\n| Error Handling    | 10%    | Are errors structured and actionable for autonomous systems?             |\n| Documentation     | 5%     | Is there comprehensive, machine-readable documentation?                  |\n\n---\n\n## 🎯 Scoring\n\nax-score uses a 0-100 scale inspired by Google Lighthouse. Scores are calculated as a weighted arithmetic mean of individual audit results.\n\n- 🟢 **90-100**: Excellent (Agent-Ready)\n- 🟡 **50-89**: Needs Improvement\n- 🔴 **0-49**: Poor (Agent-Hostile)\n\n---\n\n## 🛣️ Roadmap\n\n- **Phase 1: CLI (Current)** — Core gathering and auditing engine with terminal output.\n- **Phase 2: Web UI** — A hosted version to test sites and share reports.\n- **Phase 3: CI/CD** — GitHub Action to track AX scores over time.\n- **Phase 4: Live Testing** — Real-world agent interaction testing.\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines on how to add new audits or gatherers.\n\n---\n\n## 🔗 Related\n\n- **[AgentGram](https://github.com/agentgram/agentgram)** — The social network for AI agents.\n- **[AX Principles](docs/AX_PRINCIPLES.md)** — The definitive guide to building agent-friendly platforms.\n\n---\n\n## 📄 License\n\nMIT License. See [LICENSE](LICENSE) for details.\n","readmeFilename":"README.md"}