seodata-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SEODATA_API_KEY | Yes | API key in the form seo_<48 hex>. Required for authorized calls. Without a key the server still starts, but tools return no_api_key with a hint (useful for diagnosing client configuration). | |
| SEODATA_BASE_URL | No | Base URL of the SEO Combine (for a self-hosted copy). | https://seodata.win |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| seodata_whoamiA | Кто я: имя ключа, префикс, scopes, дневная квота и расход за сегодня. Используй первым — проверка авторизации и доступных прав. |
| seodata_list_storefrontsA | Список витрин (сайтов) владельца ключа: id, имя, slug, язык, домен. Scope: content:read. Идентификаторы отсюда нужны остальным инструментам. |
| seodata_list_articlesB | Опубликованные статьи витрины с полным контентом. Scope: content:read. |
| seodata_get_articleB | Полная опубликованная статья: заголовок, контент, meta, ключи, обложка. Scope: content:read. |
| seodata_get_pageC | Статическая страница витрины (о нас, контакты и т.п.). Scope: content:read. |
| seodata_searchB | Полнотекстовый поиск по всем опубликованным статьям владельца (заголовок, лид, контент). Scope: content:read. |
| seodata_run_auditA | SEO-аудит главной страницы домена (~5–15 с): score 0–100 + список проверок (title, meta, h1, canonical, robots, sitemap, скорость и др.). Если передать storefrontId — результат сохранится в историю аудитов витрины. Scope: audit:run. |
| seodata_generate_articleA | Запуск AI-генерации статьи в фоне (очередь комбайна). Возвращает jobId — статус смотри через seodata_get_job; готовая статья появится черновиком витрины. Scope: generate:run. |
| seodata_get_jobA | Статус фоновой задачи (например генерации статьи): pending/processing/done/error + результат/ошибка. Scope: jobs:read. |
| seodata_get_positionsB | Позиции отслеживаемых ключей витрины за последние 30 дней: плоский массив {keywordId, keyword, date, position, url}. Scope: positions:read. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| OpenAPI-спека публичного API комбайна | Живой OpenAPI 3.0 документ /api/public/v1 с сервера seodata.win |
| Статус подключения MCP к комбайну | Базовый URL, наличие ключа и доступность API |
TDQS
Scored across 10 tools
Each tool has a largely distinct purpose: identity check, storefront listing, article listing/retrieval, page retrieval, search, audit, generation, job status, and positions. There is minor overlap between seodata_list_articles (returns full content) and seodata_get_article, and seodata_search partially overlaps with listing, but the descriptions clarify scope adequately.
Nearly all tools follow a consistent seodata_verb_noun snake_case pattern (list_storefronts, get_article, run_audit, generate_article, get_job, get_positions). Only seodata_whoami deviates, being a bare noun-style identifier rather than verb_noun, but overall the convention is highly predictable.
Ten tools is well within the ideal 3-15 range and each one maps to a concrete operation (auth, listing, retrieval, search, audit, generation, jobs, positions). No redundant or filler tools are present.
The read-oriented SEO/content surface is well covered: auth, storefronts, articles, pages, search, audits, AI generation, async jobs, and position tracking. Minor gaps exist—there's no explicit article update/delete or keyword management, and audit history retrieval isn't exposed—but core workflows are supported.