pypi agent-seo-enginestdioMITupdated 10d ago
Local-first SEO scoring, search-intent and opportunity engine for AI agents. Deterministic checks before agents rewrite, refresh or publish content.
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_statusandprivacy_auditsurfaces before content tools - Runs locally by default with no required API keys
Install
pipx install agent-seo-engine
With MCP support:
pipx install "agent-seo-engine[mcp]"
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
agent-seo-engine manifest --client codex
agent-seo-engine doctor
agent-seo-engine privacy-audit
agent-seo-engine intent "best ai agent framework"
agent-seo-engine score --file examples/article.md --primary-keyword "ai agent testing"
agent-seo-engine opportunity --impressions 4200 --clicks 80 --position 12.4 --commercial-intent 0.8
agent-seo-engine image-alt --file page.html
All commands return structured JSON by default. Use --format markdown for human review.
MCP
agent-seo-mcp
Hermes-style config:
mcp_servers:
agent_seo:
command: agent-seo-mcp
args: []
sampling:
enabled: false
Recommended first calls:
agent_seo_connection_statusagent_seo_privacy_auditagent_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
Use agent-seo-engine. First call agent_seo_connection_status and agent_seo_privacy_audit.
Score the draft, then propose only edits tied to failed checks or high-impact opportunities.
Agent Contract
Agents 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.
Development
python3 -m venv .venv
. .venv/bin/activate
pip install -e ".[dev]"
pytest
python -m compileall -q src
📧 Contact & Support
- 📨 support@delx.ai — general questions, integration help, partnerships
- 🐛 Bug reports / feature requests — GitHub Issues
- 🐦 Updates — @delx369 on X
- 🌐 Site — wellness.delx.ai
インストール
agent seo engine をクライアントに追加します。お使いのものを選んでください。
claude mcp add agent-seo-engine -- uvx agent-seo-enginecodex mcp add agent-seo-engine -- uvx agent-seo-engineamp mcp add agent-seo-engine -- uvx agent-seo-engine{
"mcpServers": {
"agent-seo-engine": {
"command": "uvx",
"args": [
"agent-seo-engine"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"agent-seo-engine": {
"command": "uvx",
"args": [
"agent-seo-engine"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"agent-seo-engine","command":"uvx","args":["agent-seo-engine"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"agent-seo-engine": {
"command": "uvx",
"args": [
"agent-seo-engine"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"agent-seo-engine": {
"command": "uvx",
"args": [
"agent-seo-engine"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"agent-seo-engine": {
"command": "uvx",
"args": [
"agent-seo-engine"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"agent-seo-engine": {
"type": "local",
"command": "uvx",
"args": [
"agent-seo-engine"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"agent-seo-engine": {
"command": {
"path": "uvx",
"args": [
"agent-seo-engine"
]
}
}
}
}Add to your Zed `settings.json`.
uvx agent-seo-engineRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
スコア
39 / 100
情報不足
- ドキュメント25/25
- メンテナンス19/25
- 信頼性13/20
- 機能0/15
- 導入のしやすさ12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 3 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
バージョン履歴
| バージョン | 公開日 |
|---|---|
| 0.1.1最新 | 2026年7月3日 |