{"id":51194704,"url":"https://github.com/davidmosiah/agent-seo-engine","last_synced_at":"2026-06-27T19:02:12.288Z","repository":{"id":355831780,"uuid":"1229801161","full_name":"davidmosiah/agent-seo-engine","owner":"davidmosiah","description":"Agent-first local SEO scoring, search-intent and opportunity engine with CLI and optional MCP server.","archived":false,"fork":false,"pushed_at":"2026-05-23T18:09:21.000Z","size":102,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-23T20:10:28.618Z","etag":null,"topics":["agent-tools","agentic-workflows","ai-agents","claude","cli","codex","content-ops","dry-run","local-first","markdown","mcp","mcp-server","pypi","python","search-intent","seo","seo-tools"],"latest_commit_sha":null,"homepage":"https://github.com/davidmosiah/agent-seo-engine","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/davidmosiah.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-05T11:54:14.000Z","updated_at":"2026-05-23T18:09:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/davidmosiah/agent-seo-engine","commit_stats":null,"previous_names":["davidmosiah/agent-seo-engine"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/davidmosiah/agent-seo-engine","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidmosiah%2Fagent-seo-engine","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidmosiah%2Fagent-seo-engine/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidmosiah%2Fagent-seo-engine/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidmosiah%2Fagent-seo-engine/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/davidmosiah","download_url":"https://codeload.github.com/davidmosiah/agent-seo-engine/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidmosiah%2Fagent-seo-engine/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34864431,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-27T02:00:06.362Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-tools","agentic-workflows","ai-agents","claude","cli","codex","content-ops","dry-run","local-first","markdown","mcp","mcp-server","pypi","python","search-intent","seo","seo-tools"],"created_at":"2026-06-27T19:02:10.730Z","updated_at":"2026-06-27T19:02:12.284Z","avatar_url":"https://github.com/davidmosiah.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- delx header v2 --\u003e\n\u003ch1 align=\"center\"\u003eAgent SEO Engine\u003c/h1\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"assets/banner.png\" alt=\"Agent SEO Engine\" width=\"85%\" /\u003e\n\u003c/div\u003e\n\n\u003ch3 align=\"center\"\u003e\n  Local-first SEO scoring, search-intent and opportunity engine for AI agents.\u003cbr\u003eDeterministic checks before agents rewrite, refresh or publish content.\n\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://pypi.org/project/agent-seo-engine/\"\u003e\u003cimg src=\"https://img.shields.io/pypi/v/agent-seo-engine?style=for-the-badge\u0026labelColor=0F172A\u0026color=10B981\u0026logo=pypi\u0026logoColor=white\" alt=\"PyPI version\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://pypi.org/project/agent-seo-engine/\"\u003e\u003cimg src=\"https://img.shields.io/pypi/pyversions/agent-seo-engine?style=for-the-badge\u0026labelColor=0F172A\u0026color=0EA5A3\u0026logo=python\u0026logoColor=white\" alt=\"Python versions\" /\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/LICENSE-MIT-22C55E?style=for-the-badge\u0026labelColor=0F172A\" alt=\"License MIT\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://modelcontextprotocol.io\"\u003e\u003cimg src=\"https://img.shields.io/badge/BUILT_FOR-MCP-7C3AED?style=for-the-badge\u0026labelColor=0F172A\" alt=\"Built for MCP\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/davidmosiah/agent-seo-engine/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/davidmosiah/agent-seo-engine?style=for-the-badge\u0026labelColor=0F172A\u0026color=FBBF24\u0026logo=github\" alt=\"GitHub stars\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/davidmosiah/agent-seo-engine/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://github.com/davidmosiah/agent-seo-engine/actions/workflows/ci.yml/badge.svg\" alt=\"CI status\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/davidmosiah\"\u003e\u003cimg src=\"https://img.shields.io/badge/PART_OF-Delx_Agent_Stack-0EA5A3?style=for-the-badge\u0026labelColor=0F172A\" alt=\"Part of the Delx agent stack\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/davidmosiah/agent-seo-engine\"\u003e\u003cimg src=\"https://img.shields.io/badge/CATEGORY-Reach-0EA5A3?style=for-the-badge\u0026labelColor=0F172A\" alt=\"Category\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003e ⭐ **If this agent-first tool helps your workflow, please star the repo.** Stars make this tooling easier for other builders to discover and help Delx keep shipping open infrastructure.\u003cbr\u003e\n\u003e 🧱 Part of the [Delx agent stack](https://github.com/davidmosiah) \u0026mdash; 15 open-source MCP servers across **body, reach and coordination**.\n\n---\n\n\u003c!-- /delx header v2 --\u003e\n\nAgent-first SEO scoring, search-intent detection and opportunity prioritization. It packages the useful parts of a production content pipeline into a clean local CLI plus an optional MCP server for Codex, Claude, Cursor, Hermes, OpenClaw and other agent runtimes.\n\nUse it when an agent needs deterministic SEO checks before rewriting, refreshing or publishing content.\n\n## What It Does\n\n- Classifies search intent: informational, navigational, transactional and commercial investigation\n- Scores markdown articles for agent-readable SEO gaps\n- Prioritizes GSC-style opportunities by impressions, position, CTR gap, conversions and commercial value\n- Exposes `manifest`, `connection_status` and `privacy_audit` surfaces before content tools\n- Runs locally by default with no required API keys\n\n## Install\n\n```bash\npipx install agent-seo-engine\n```\n\nWith MCP support:\n\n```bash\npipx install \"agent-seo-engine[mcp]\"\n```\n\nPublished on PyPI: [`agent-seo-engine`](https://pypi.org/project/agent-seo-engine/). Release automation uses PyPI Trusted Publishing, so GitHub Actions can publish future versions without long-lived PyPI tokens. See [docs/pypi-publishing.md](docs/pypi-publishing.md).\n\n## CLI\n\n```bash\nagent-seo-engine manifest --client codex\nagent-seo-engine doctor\nagent-seo-engine privacy-audit\nagent-seo-engine intent \"best ai agent framework\"\nagent-seo-engine score --file examples/article.md --primary-keyword \"ai agent testing\"\nagent-seo-engine opportunity --impressions 4200 --clicks 80 --position 12.4 --commercial-intent 0.8\nagent-seo-engine image-alt --file page.html\n```\n\nAll commands return structured JSON by default. Use `--format markdown` for human review.\n\n## MCP\n\n```bash\nagent-seo-mcp\n```\n\nHermes-style config:\n\n```yaml\nmcp_servers:\n  agent_seo:\n    command: agent-seo-mcp\n    args: []\n    sampling:\n      enabled: false\n```\n\nRecommended first calls:\n\n1. `agent_seo_connection_status`\n2. `agent_seo_privacy_audit`\n3. `agent_seo_score_content`\n\n## Agent Surfaces\n\n| Tool | Purpose |\n|---|---|\n| `agent_seo_manifest` | Install/runtime guidance for agent clients |\n| `agent_seo_connection_status` | Local/offline readiness and optional integration status |\n| `agent_seo_privacy_audit` | Draft, analytics and credential boundaries |\n| `agent_seo_detect_intent` | Search intent classification |\n| `agent_seo_score_content` | Markdown quality checks with exact recommendations |\n| `agent_seo_prioritize_opportunity` | GSC-style opportunity scoring |\n| `agent_seo_check_image_alt` | Image `alt`-attribute coverage audit for HTML |\n\n## Copy-Paste Agent Prompt\n\n```text\nUse agent-seo-engine. First call agent_seo_connection_status and agent_seo_privacy_audit.\nScore the draft, then propose only edits tied to failed checks or high-impact opportunities.\n```\n\n## Agent Contract\n\nAgents should not guess whether a draft is ready. They should call the scoring tool, read exact failed checks, then propose focused edits. The engine is intentionally deterministic and local so repeated agent runs can compare output over time.\n\n## Development\n\n```bash\npython3 -m venv .venv\n. .venv/bin/activate\npip install -e \".[dev]\"\npytest\npython -m compileall -q src\n```\n\n---\n\n## 📧 Contact \u0026 Support\n\n- 📨 **support@delx.ai** — general questions, integration help, partnerships\n- 🐛 **Bug reports / feature requests** — [GitHub Issues](https://github.com/davidmosiah/agent-seo-engine/issues)\n- 🐦 **Updates** — [@delx369](https://x.com/delx369) on X\n- 🌐 **Site** — [wellness.delx.ai](https://wellness.delx.ai)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidmosiah%2Fagent-seo-engine","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavidmosiah%2Fagent-seo-engine","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidmosiah%2Fagent-seo-engine/lists"}