Metadata-Version: 2.4
Name: stobo-mcp
Version: 0.3.7
Summary: MCP server for Stobo — AI-powered SEO/AEO content optimization
Project-URL: Homepage, https://trystobo.com
Project-URL: Documentation, https://trystobo.com
Project-URL: Repository, https://github.com/stobo-app/stobo-cli
Author-email: Stobo <hello@trystobo.com>
License-Expression: MIT
License-File: LICENSE
Keywords: aeo,ai,claude,mcp,model-context-protocol,seo
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Python: >=3.10
Requires-Dist: mcp>=1.0.0
Requires-Dist: stobo>=0.3.5
Description-Content-Type: text/markdown

# Stobo MCP Server

MCP server for [Stobo](https://trystobo.com) — AI-powered SEO/AEO content optimization. Use Stobo's audit, tone extraction, llms.txt generation, and optimization tools directly from Claude Desktop.

## Install

```bash
pip install stobo-mcp
```

## Setup

Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "stobo": {
      "command": "stobo-mcp",
      "env": {
        "STOBO_API_KEY": "your-api-key",
        "STOBO_BASE_URL": "https://api.trystobo.com"
      }
    }
  }
}
```

## Available Tools (19)

### Site & Article Audits

| Tool | Auth | Description |
|------|------|-------------|
| `audit_site` | Free | **Main entry point.** Full site audit: 30 SEO + 7 AEO checks + blog detection + sitemap discovery |
| `audit_article` | Free | Article-level SEO + AEO audit (for specific blog posts) |
| `audit_seo` | Free | SEO-only audit on a single page |
| `audit_aeo` | Free | AEO-only audit on a single page |
| `get_audit` | Key | Fetch audit results by ID |
| `list_audits` | Key | List recent audits |

### Brand Voice & Optimization

| Tool | Auth | Description |
|------|------|-------------|
| `extract_tone` | Paid | Extract brand voice profile from a blog (500 credits) |
| `get_tone` | Key | Get a stored tone profile |
| `list_tone_profiles` | Key | List all tone profiles |
| `delete_tone` | Key | Delete a stored tone profile |
| `optimize` | Paid | Start full optimization pipeline: audit + tone + rewrite (1,000 credits) |
| `get_job` | Key | Check optimization job status |
| `get_job_preview` | Key | Get before/after preview of a completed optimization |
| `list_jobs` | Key | List optimization jobs |

### Content & Reports

| Tool | Auth | Description |
|------|------|-------------|
| `generate_llms_txt` | Paid | Generate a llms.txt file for AI discoverability (500 credits) |
| `freshness_audit` | Free | Audit sitemap for content freshness (dateModified schema) |
| `get_freshness` | Key | Get a previously completed freshness audit |
| `export_report` | Paid | Generate a markdown report (200 credits) |
| `get_export` | Key | Get a cached export report |

### Account

| Tool | Auth | Description |
|------|------|-------------|
| `get_credits` | Key | Check credit usage, balance, and breakdown |

## Routing Rules

- **Default:** Use `audit_site` for any domain, homepage, or generic "audit this" request
- **Only** use `audit_article` when the URL is clearly a specific blog post (contains `/blog/`, `/post/`, `/article/`)

Examples:
- "audit phantombuster.com" -> `audit_site`
- "audit https://example.com" -> `audit_site`
- "check https://example.com/blog/my-post" -> `audit_article`

## Usage in Claude Desktop

Just ask Claude:

- "Audit https://example.com" (uses audit_site)
- "Deep-dive https://example.com/blog/my-post" (uses audit_article)
- "Extract the brand voice from https://example.com/blog"
- "Generate a llms.txt for https://example.com"
- "Optimize https://example.com/blog/my-article"
- "How many credits do I have left?"

## What's New in 0.2.0

- `audit_site` — full website audit with combined score, SEO categories, AEO checklist, blog detection, sitemap discovery
- `generate_llms_txt` — create spec-compliant llms.txt files
- `delete_tone` — delete stored brand voice profiles
- `get_job_preview` / `list_jobs` — optimization job management
- `get_freshness` / `get_export` — retrieve cached results
- `get_credits` — check credit usage and balance
- Improved tool descriptions with routing rules and formatting guidance

## Get an API Key

1. Sign up at [trystobo.com](https://trystobo.com)
2. Go to Settings > API Keys
3. Create a new key and add it to your Claude Desktop config

## License

MIT
