creator-seo-mcp
An MCP server for content creators that connects Google Search Console to your page content and ranks every SEO opportunity by estimated revenue, not vanity clicks.
Generic SEO tools surface raw GSC numbers. This one tells you which fix pays most, based on your actual display-ad RPM and affiliate commission rates.
What it does
Six tools, designed to work together in a full creator-SEO workflow:
| Tool | Description |
|---|---|
get_striking_distance_keywords |
Queries ranking at positions 4-15 with real impression volume, the ranking page, and the gap to page 1 |
get_page_performance |
Full GSC picture for one URL: clicks, impressions, CTR, position, and the queries driving it |
analyze_content_decay |
Flags pages losing clicks or impressions month-over-month |
audit_page_onpage |
Fetches a URL, reads title/meta/headings/body, compares against a target query, and proposes concrete edits |
find_cannibalization |
Detects queries where multiple pages compete, splitting authority |
get_top_opportunities |
The headline call: combines all signals, weights by revenue, returns a single ranked action list |
Install
uvx creator-seo-mcp
Or with pip:
pip install creator-seo-mcp
Setup
1. Google Search Console credentials
Follow docs/gsc-setup.md to:
- Enable the Search Console API in Google Cloud
- Create an OAuth 2.0 Desktop client
- Download
credentials.json
2. Claude Desktop config
Add to your claude_desktop_config.json:
{
"mcpServers": {
"creator-seo-mcp": {
"command": "uvx",
"args": ["creator-seo-mcp"],
"env": {
"GOOGLE_CREDENTIALS_PATH": "/path/to/credentials.json",
"CREATOR_SEO_SITE_RPM": "15"
}
}
}
}
3. Claude Code config
claude mcp add creator-seo-mcp uvx creator-seo-mcp \
-e GOOGLE_CREDENTIALS_PATH=/path/to/credentials.json \
-e CREATOR_SEO_SITE_RPM=15
4. Revenue config (optional but recommended)
Set your display-ad RPM so opportunities are ranked by real dollars:
export CREATOR_SEO_SITE_RPM=22 # your Mediavine/Raptive RPM
export CREATOR_SEO_AFFILIATE_CATEGORIES='{"gaming-deals": 2.0}'
See .env.example for all options.
Example agent prompts
- "Show me my top five revenue-weighted SEO opportunities for this week."
- "Which of my posts are losing traffic compared to last month?"
- "My Baldur's Gate 3 build guide is stuck on page 2. Audit it against its main keyword and tell me what to fix."
- "Find any posts that are competing with each other for the same search term."
- "What is the on-page gap between this article and the query it is trying to rank for?"
Two Average Gamers case study
Before/after numbers to be added after dogfood phase.
Contributing
Issues and PRs welcome. See CONTRIBUTING.md for guidelines.
License
MIT
1 maintainer
Metadata
1 maintainer
Release files for creator-seo-mcp 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| creator_seo_mcp-0.1.1.tar.gz | 16.6 kB | Without provenance | Details for creator_seo_mcp-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| creator_seo_mcp-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for creator_seo_mcp-0.1.1-py3-none-any.whl |
Total release size: 31.7 kB
Release files / creator_seo_mcp-0.1.1.tar.gz
| Download URL | creator_seo_mcp-0.1.1.tar.gz |
|---|---|
| Size | 16.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ed2591cec23325488b31ebb60f4c469a7a6aaa4292966228ed00609350ec766b
|
|
BLAKE2b-256 checksum How to use checksums |
9a77f8a8134bc6a4153a1f10ff8112cd88b3185f5a089eee685616b96c123fbf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.29 {"installer":{"name":"uv","version":"0.9.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / creator_seo_mcp-0.1.1-py3-none-any.whl
| Download URL | creator_seo_mcp-0.1.1-py3-none-any.whl |
|---|---|
| Size | 15.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f146cfdb68fa9e9eac1e8c3089088fb6855e7d2257b90a3e47594a4581f9a4f2
|
|
BLAKE2b-256 checksum How to use checksums |
63603d820cd421d4bd54e8b3f91760f72d038507f9a2d782fb26646262478222
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.29 {"installer":{"name":"uv","version":"0.9.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for creator-seo-mcp 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
