概览
What is SEO Tools MCP Server?
An stdio MCP server that allows LLMs to interact with DataForSEO API endpoints and other SEO tools for tasks like keyword research, backlink analysis, and SERP data retrieval.
How to use SEO Tools MCP Server?
Clone the repository, install dependencies, build, set required environment variables (DATAFORSEO_LOGIN, DATAFORSEO_PASSWORD, optionally LOCALFALCON_API_KEY), then run npm start. Tools can be filtered using ENABLED_MODULES or ENABLED_TOOLS environment variables to reduce context usage.
Key features of SEO Tools MCP Server
- Comprehensive coverage of DataForSEO API endpoints across 12 categories
- Optional Local Falcon API integration for local ranking analysis
- Type-safe tool definitions with Zod schemas
- Selective module and tool filtering via environment variables
- Detailed error reporting and authentication handling
- Extensible architecture for adding new API integrations
Use cases of SEO Tools MCP Server
- Perform keyword research and analyze search volume trends
- Conduct backlink audits and identify referring domains
- Run technical SEO audits using the OnPage API
- Analyze business listings and local search rankings
- Generate content or extract AI model responses for SEO optimization
FAQ from SEO Tools MCP Server
How do I authenticate with the server?
Set DATAFORSEO_LOGIN and DATAFORSEO_PASSWORD as environment variables. For Local Falcon, also set LOCALFALCON_API_KEY.
Why do I get 404 errors on some endpoints?
A 404 on a known live endpoint typically means the corresponding DataForSEO module is not enabled for your account, not a server bug. The server now normalizes such responses with a clear message.
Can I reduce the number of tools exposed to the LLM?
Yes. Use ENABLED_MODULES to enable only specific API categories (comma-separated, case-insensitive) or ENABLED_TOOLS for fine-grained control over individual tools.
What are the runtime dependencies?
Node.js and npm are required. All other dependencies are installed via npm install.
Does the server store any data locally?
No. All data is retrieved live from DataForSEO or Local Falcon APIs. Credentials are read from environment variables only and never committed.
