textabra-mcp 0.1.0__tar.gz

textabra_mcp-0.1.0/.gitignore

@@ -0,0 +1,3 @@
+__pycache__/
+*.egg-info/
+dist/

textabra_mcp-0.1.0/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Textabra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

textabra_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,64 @@
+Metadata-Version: 2.5
+Name: textabra-mcp
+Version: 0.1.0
+Summary: MCP-сервер Textabra: отчёты по страницам, проверки и задания для ИИ-редактора из Claude, Cursor и других агентов
+Project-URL: Homepage, https://www.textabra.ru
+Project-URL: Documentation, https://www.textabra.ru/api/docs
+Author-email: Textabra <hi@textabra.ru>
+License: MIT
+License-File: LICENSE
+Keywords: claude,cursor,mcp,model-context-protocol,seo,textabra
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: mcp>=1.2
+Description-Content-Type: text/markdown
+
+# textabra-mcp
+
+MCP-сервер Textabra. Подключает ИИ-агента (Claude Desktop, Claude Code, Cursor) к вашим проектам в Textabra через публичный API: агент смотрит отчёты по страницам, запускает проверки и получает задание для ИИ-редактора.
+
+Нужен тариф «Профи» или «Корпоративный» и API-ключ из раздела «API-ключи» в настройках Textabra.
+
+## Подключение
+
+Claude Desktop, файл `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "textabra": {
+      "command": "uvx",
+      "args": ["textabra-mcp"],
+      "env": { "TEXTABRA_API_KEY": "tx_ваш_ключ" }
+    }
+  }
+}
+```
+
+Claude Code:
+
+```bash
+claude mcp add textabra --env TEXTABRA_API_KEY=tx_ваш_ключ -- uvx textabra-mcp
+```
+
+Из локальной копии репозитория (до публикации пакета): `uvx --from ./mcp textabra-mcp`.
+
+## Инструменты
+
+| Инструмент | Что делает |
+|---|---|
+| `account_status` | тариф, лимиты, использованная квота проверок |
+| `list_projects`, `create_project` | проекты |
+| `list_pages`, `add_urls` | страницы проекта, добавление URL с запуском проверки |
+| `get_page_report` | 8 оценок качества, SEO-чеклист, семантика |
+| `recheck_page` | перепроверка (`seo` бесплатно, остальное списывает квоту) |
+| `get_brief` | задание для ИИ-редактора по странице |
+
+Платные действия списывают проверки из общей квоты аккаунта (на «Профи» 1100 за 30 дней). Описание API: https://www.textabra.ru/api/docs
+
+Переменные окружения: `TEXTABRA_API_KEY` (обязательно), `TEXTABRA_API_URL` (по умолчанию `https://www.textabra.ru/api/v1`).

textabra_mcp-0.1.0/README.md

@@ -0,0 +1,44 @@
+# textabra-mcp
+
+MCP-сервер Textabra. Подключает ИИ-агента (Claude Desktop, Claude Code, Cursor) к вашим проектам в Textabra через публичный API: агент смотрит отчёты по страницам, запускает проверки и получает задание для ИИ-редактора.
+
+Нужен тариф «Профи» или «Корпоративный» и API-ключ из раздела «API-ключи» в настройках Textabra.
+
+## Подключение
+
+Claude Desktop, файл `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "textabra": {
+      "command": "uvx",
+      "args": ["textabra-mcp"],
+      "env": { "TEXTABRA_API_KEY": "tx_ваш_ключ" }
+    }
+  }
+}
+```
+
+Claude Code:
+
+```bash
+claude mcp add textabra --env TEXTABRA_API_KEY=tx_ваш_ключ -- uvx textabra-mcp
+```
+
+Из локальной копии репозитория (до публикации пакета): `uvx --from ./mcp textabra-mcp`.
+
+## Инструменты
+
+| Инструмент | Что делает |
+|---|---|
+| `account_status` | тариф, лимиты, использованная квота проверок |
+| `list_projects`, `create_project` | проекты |
+| `list_pages`, `add_urls` | страницы проекта, добавление URL с запуском проверки |
+| `get_page_report` | 8 оценок качества, SEO-чеклист, семантика |
+| `recheck_page` | перепроверка (`seo` бесплатно, остальное списывает квоту) |
+| `get_brief` | задание для ИИ-редактора по странице |
+
+Платные действия списывают проверки из общей квоты аккаунта (на «Профи» 1100 за 30 дней). Описание API: https://www.textabra.ru/api/docs
+
+Переменные окружения: `TEXTABRA_API_KEY` (обязательно), `TEXTABRA_API_URL` (по умолчанию `https://www.textabra.ru/api/v1`).

textabra_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "textabra-mcp"
+version = "0.1.0"
+description = "MCP-сервер Textabra: отчёты по страницам, проверки и задания для ИИ-редактора из Claude, Cursor и других агентов"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Textabra", email = "hi@textabra.ru" }]
+keywords = ["mcp", "seo", "textabra", "claude", "cursor", "model-context-protocol"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Internet :: WWW/HTTP :: Indexing/Search",
+]
+dependencies = ["mcp>=1.2", "httpx>=0.27"]
+
+[project.urls]
+Homepage = "https://www.textabra.ru"
+Documentation = "https://www.textabra.ru/api/docs"
+
+[project.scripts]
+textabra-mcp = "textabra_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["textabra_mcp"]

textabra_mcp-0.1.0/textabra_mcp/server.py

@@ -0,0 +1,96 @@
+"""MCP-сервер Textabra: даёт ИИ-агентам (Claude, Cursor и другим) доступ к вашим проектам через публичный API v1.
+
+Запуск: `textabra-mcp` (stdio). Ключ берётся из переменной окружения TEXTABRA_API_KEY (создаётся в настройках Textabra,
+тарифы «Профи» и «Корпоративный»). Адрес API можно переопределить через TEXTABRA_API_URL.
+"""
+
+import os
+
+import httpx
+try:  # mcp 2.x переименовал FastMCP в MCPServer
+    from mcp.server.mcpserver import MCPServer as _Server
+    from mcp.server.mcpserver.exceptions import ToolError
+except ImportError:  # mcp 1.x
+    from mcp.server.fastmcp import FastMCP as _Server
+    from mcp.server.fastmcp.exceptions import ToolError
+
+BASE_URL = os.getenv("TEXTABRA_API_URL", "https://www.textabra.ru/api/v1").rstrip("/")
+
+mcp = _Server("textabra")
+
+
+def _call(method: str, path: str, **kwargs):
+    key = os.getenv("TEXTABRA_API_KEY", "").strip()
+    if not key:
+        raise ToolError("Не задан TEXTABRA_API_KEY: создайте ключ в настройках Textabra (раздел «API-ключи») и передайте его в переменной окружения.")
+    try:
+        r = httpx.request(method, BASE_URL + path, headers={"Authorization": f"Bearer {key}"}, timeout=60, **kwargs)
+    except httpx.HTTPError as e:
+        raise ToolError(f"Не удалось связаться с Textabra: {e}") from e
+    if r.status_code >= 400:
+        try:
+            msg = r.json().get("error") or r.text[:200]
+        except ValueError:
+            msg = r.text[:200]
+        raise ToolError(f"Textabra вернул {r.status_code}: {msg}")
+    return r.json()
+
+
+@mcp.tool()
+def account_status() -> dict:
+    """Тариф аккаунта, лимиты и сколько уже использовано: проекты, страницы, проверки за последние 30 дней."""
+    return _call("GET", "/me")
+
+
+@mcp.tool()
+def list_projects() -> dict:
+    """Список проектов аккаунта (id, название, число страниц)."""
+    return _call("GET", "/projects")
+
+
+@mcp.tool()
+def create_project(name: str) -> dict:
+    """Создать проект с указанным названием. Возвращает id проекта."""
+    return _call("POST", "/projects", json={"name": name})
+
+
+@mcp.tool()
+def list_pages(project_id: int) -> dict:
+    """Страницы проекта с общим баллом 0-100, баллом качества, SEO-чеклистом и семантикой."""
+    return _call("GET", f"/projects/{project_id}/pages")
+
+
+@mcp.tool()
+def add_urls(project_id: int, urls: list[str]) -> dict:
+    """Добавить URL в проект и запустить полную проверку (до 100 адресов за вызов).
+    Каждая страница списывает одну проверку из квоты. Результаты появятся в list_pages и get_page_report через 1-2 минуты."""
+    return _call("POST", f"/projects/{project_id}/pages", json={"urls": urls})
+
+
+@mcp.tool()
+def get_page_report(page_id: int, full: bool = False) -> dict:
+    """Отчёт по странице: 8 оценок качества с комментариями, SEO-чеклист, семантический анализ.
+    full=true добавляет полные данные снимка страницы и семантического отчёта (большой ответ)."""
+    return _call("GET", f"/pages/{page_id}", params={"include": "seo_data,semantic_report"} if full else None)
+
+
+@mcp.tool()
+def recheck_page(page_id: int, what: str = "all") -> dict:
+    """Перепроверить страницу: what = seo (бесплатно) | quality | semantic | all. Платные виды списывают одну проверку из квоты.
+    Проверка идёт в фоне 1-2 минуты; затем забирайте результат через get_page_report."""
+    return _call("POST", f"/pages/{page_id}/recheck", json={"what": what})
+
+
+@mcp.tool()
+def get_brief(page_id: int, mode: str = "edit") -> str:
+    """Задание для ИИ-редактора по странице на основе анализа Textabra: что поправить, какие темы и сущности добавить.
+    mode = edit (доработать текст) | write (написать заново). Нужен готовый семантический анализ (recheck_page с what=semantic)."""
+    return _call("GET", f"/pages/{page_id}/brief", params={"mode": mode})["prompt"]
+
+
+def main() -> None:
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()