davidmosiah/agent-seo-engine

Local-first SEO scoring, search-intent and opportunity engine for AI agents. Deterministic checks before agents rewrite, refresh or publish content.
mcp-name: io.github.davidmosiah/agent-seo-engine
> ⭐ **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.
> 🧱 Part of the Delx agent stack — 15 open-source MCP servers across **body, reach and coordination**.
---
Agent-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.
Use it when an agent needs deterministic SEO checks before rewriting, refreshing or publishing content.
What It Does
- Classifies search intent: informational, navigational, transactional and commercial investigation
- Scores markdown articles for agent-readable SEO gaps
- Prioritizes GSC-style opportunities by impressions, position, CTR gap, conversions and commercial value
- Exposes manifest, connection_status and privacy_audit surfaces before content tools
- Runs locally by default with no required API keys
Install
With MCP support:
Published on PyPI: 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.
CLI
All commands return structured JSON by default. Use --format markdown for human review.
MCP
Hermes-style config:
Recommended first calls:
1. agent_seo_connection_status
2. agent_seo_privacy_audit
3. agent_seo_score_content
Agent Surfaces
| Tool | Purpose |
|---|---|
| agent_seo_manifest | Install/runtime guidance for agent clients |
| agent_seo_connection_status | Local/offline readiness and optional integration status |
| agent_seo_privacy_audit | Draft, analytics and credential boundaries |
| agent_seo_detect_intent | Search intent classification |
| agent_seo_score_content | Markdown quality checks with exact recommendations |
| agent_seo_prioritize_opportunity | GSC-style opportunity scoring |
| agent_seo_check_image_alt | Image alt-attribute coverage audit for HTML |
Copy-Paste Agent Prompt