Проекти

Project API (Cursor и агенти)

Read-only достъп до данните на един проект с Bearer token — за SEO/AEO работа в отделен Cursor проект.

Всеки проект може да има един активен API token. Token-ът дава само четене на данните за този проект — не пуска проверки и не променя настройки.

1
Отвори Настройки на проекта
Панелът „Project API“ е близо до споделянето.
2
Генерирай token
Копирай го веднага — показва се само веднъж. Старият token спира да работи.
3
Сложи го в клиентския Cursor проект
Напр. env променлива WRS_SEO_TOKEN или .env (не го комитвай в публичен repo).
4
Извикай snapshot
GET https://seo.wrs.bg/api/v1/snapshot с Header Authorization: Bearer wrs_p_…

/api/v1/project: Резюме: позиции, прогноза, видимост, GSC кликове, AI и audit скор.
/api/v1/rankings: Ключови думи: обем, mobile/desktop позиция, прогноза, ranking URL, SERP features, AI колони.
/api/v1/audit: Последен Website Audit + страници с проблеми (?limit=200).
/api/v1/ai: AI Tracker статуси (цитиран / споменат / липсва) по двигател.
/api/v1/traffic: GSC кликове/импресии (28 дни) и прогноза за трафик.
/api/v1/snapshot: Всичко заедно — удобно за един файл в .seo_audit/wrs-snapshot.json.

Въпроси и отговори

Може ли един token за всички проекти?

Не. Token-ът е по проект — всеки сайт има свой. Така агентът за victoria-gold.hu не вижда други клиенти.

API-то пуска ли платени проверки?

Не. Само чете вече събраните данни.

Къде да пазя token-а в Cursor?

В .env или user/project secret, не в git. В чата можеш да кажеш на агента да ползва WRS_SEO_TOKEN и endpoint /api/v1/snapshot.