Rankship MCP Server

Your AI does your SEO now.

Rankship is an MCP Server that turns Claude, Cursor, Windsurf, or any MCP-compatible AI into your autonomous SEO agent. Analyze your website, find keyword opportunities across 172+ countries with real DataForSEO data, and generate GEO-optimized articles — all from a single conversation.

Quick Start

Claude Desktop

Add to your config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "rankship": {
      "command": "npx",
      "args": ["-y", "rankship-mcp"],
      "env": {
        "RANKSHIP_API_KEY": "your-api-key",
        "RANKSHIP_EMAIL": "[email protected]",
        "RANKSHIP_PASSWORD": "your-password"
      }
    }
  }
}

Claude Code

claude mcp add rankship -- npx -y rankship-mcp

Cursor / Windsurf

Add the same JSON config to your MCP settings. See your editor's documentation for the config file location.

Get your API key at rankship.io

What You Can Do

Just talk to your AI. Rankship gives it 12 tools to handle your entire SEO workflow:

| Tool | What it does | |------|-------------| | analyze_website | Scan any URL and extract product info automatically | | save_onboarding | Save or update your product details | | get_product_info | Get current product details and seed keywords | | list_products | List all your products | | get_market_recommendations | Get AI-powered top 3 market recommendations for your product | | research_market | Run keyword research for any of 172+ countries (real DataForSEO data) | | get_keywords | Get and filter keywords from a researched market | | generate_article | Generate a GEO-optimized article for a keyword | | list_articles | List all your articles, filter by status or country | | get_article | Get full article content | | update_article | Edit content, title, or publish status | | check_usage | Check your remaining quota and billing period |

Example Workflow

Once installed, just tell your AI what you want:

You: "Analyze example.com and set up my product"
You: "What are the best markets for my product?"
You: "Research keywords in Germany"
You: "Show me low-difficulty keywords with high volume"
You: "Write an article targeting the best keyword"
You: "Publish it"

That's it. From zero to published SEO content in one conversation.

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | RANKSHIP_API_KEY | Yes | — | Your Rankship API key | | RANKSHIP_EMAIL | Yes | — | Account email | | RANKSHIP_PASSWORD | Yes | — | Account password | | RANKSHIP_API_URL | No | https://api.rankship.net | API endpoint |

Building from Source

git clone https://github.com/Wakkos/rankship-mcp.git
cd rankship-mcp
npm install
npm run build

Requirements

• Node.js 18+
• A Rankship account

Links

• Website
• npm Package
• Get your API key

License

MIT