seo
Miraqo отдаёт ассистенту данные SEO-проекта — позиции, аудит, обратные ссылки, видимость в AI-поиске
Что умеет
- Получать список проектов и последний аудит сайта
- Смотреть позиции ключевых слов и их историю
- Анализировать конкурентов и разрыв по ключевым словам
- Проверять техническое состояние сайта и Core Web Vitals
- Отслеживать видимость сайта в ответах AI-систем
Какие данные видит
Доступ выдаётся через OAuth к проектам конкретного аккаунта Miraqo, отозвать его можно в любой момент из настроек.
Нужен ли аккаунт
Не нужен: сервер работает без входа
Miraqo — платформа SEO и AI-видимости. MCP-сервер подключает Claude, ChatGPT, Gemini или Cursor к проектам Miraqo, чтобы задавать вопросы обычным языком и получать ответы на основе реальных данных: позиции по ключевым словам, технический аудит сайта, обратные ссылки, анализ конкурентов, данные Google Search Console, локальное SEO и видимость сайта в ответах AI-ассистентов. Доступно 26 инструментов на чтение и запись, подключение через OAuth без установки.
Как подключить
Как подключить seo к Claude
Адрес сервера, который нужно вставить в настройках Claude:
https://seo--miraqo.run.tools
- Откройте Claude (сайт claude.ai или приложение для компьютера).
- Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
- Нажмите Добавить пользовательский коннектор (Add custom connector).
- Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
- В чате нажмите + → Коннекторы и включите новый коннектор.
Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.
Авторизация
После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.
Как подключить seo к ChatGPT
Адрес сервера, который нужно вставить в настройках ChatGPT:
https://seo--miraqo.run.tools
- Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
- Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
- Откройте Настройки → Коннекторы и нажмите Создать (Create).
- Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
- В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
- В новом чате откройте + → Приложения/Коннекторы и включите коннектор.
Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.
Авторизация
При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.
Как подключить seo к Cursor
Адрес сервера, который нужно вставить в настройках Cursor:
https://seo--miraqo.run.tools
Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.
Вручную:
- В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
- Вставьте JSON, скопированный ниже, в открывшийся файл
~/.cursor/mcp.json(для одного проекта:.cursor/mcp.jsonв корне проекта). - Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.
Авторизация
Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.
Список инструментов сервера (26)
Технические названия из tools/list. Нужны только разработчикам.
| list_projects | Elenca i progetti SEO visibili al token, con l'ultimo audit (id, stato, data, punteggio). Punto di partenza per ottenere i project_id usati dagli altri strumenti. |
| get_audit_overview | Riepilogo dell'ultimo SEO audit completato di un progetto: punteggio, pagine, errori e disponibilità della topical architecture (strutturale e rifinita AI). |
| get_topical_architecture | Topical architecture dell'ultimo audit: summary, cluster/silo con pillar (url, in/out link, word_count), sorgente dei silo (menu o link), diagnostico silo_assign e conteggi anomalie. view: auto (default, AI se disponibile) | structural | ai. |
| get_cluster_pages | Pagine di un cluster/silo (o di tutto il sito) ordinate per in-link, con i campi diagnostici: word_count, silo_signal, is_taxonomy, is_product, depth, scci. Paginato (max 100). |
| find_pages | Cerca pagine per sottostringa in URL o titolo e ritorna i campi diagnostici del nodo (cluster, silo_signal, word_count, is_taxonomy, is_product…). Max 30 risultati. |
| get_keywords | Keyword tracciate di un progetto con ultima posizione, URL e SERP AI Overview, più summary (media posizioni, top 3/10). Paginato (max 100). |
| get_keyword_history | Storico posizioni di una keyword tracciata (fino a 365 giorni) con feature SERP: AI Overview, featured snippet, citazioni AIO. |
| get_competitors | Competitor monitorati del progetto: posizione media sulle keyword tracciate e conteggio del keyword gap (totale e non coperto). |
| get_keyword_gap | Keyword gap dai competitor: keyword per cui un competitor si posiziona, con volume, posizione, difficulty, cpc e URL. only_uncovered=true (default) mostra solo quelle che il progetto NON copre. Paginato (max 100). |
| get_backlinks | Backlink monitorati del progetto: totali dell'ultimo snapshot (nuovi/persi, referring domains, domain rank) e righe con anchor, dofollow, stato, spam score. Paginato (max 100). |
| get_ai_visibility | Presenza AI del progetto. Senza prompt_id: prompt monitorati con ultimo risultato per fonte (menzione brand, citazione URL, Share of Voice) e peso crediti. Con prompt_id: storico dei risultati con citazioni e brand menzionati. |
| get_audit_issues | Problemi dell'ultimo SEO audit completato: punteggio, pagine scansionate e contatori issue non a zero (404, title, duplicati, sicurezza, sitemap…). |
| get_audit_pages | Pagine dell'ultimo SEO audit con status, title, word count, tempi (load, LCP, TTI) e flag dei problemi. Filtrabile per issue e ordinabile. Paginato (max 100). `issue="errors"` sono le pagine 4xx/5xx: i redirect NON compaiono qui (il crawler li segue e salva lo status finale) — per quelli usa get_audit_redirects. |
| get_audit_redirects | Catene di redirect dell'ultimo audit (URL iniziale, hop, destinazione finale, status, loop) con `linked_from`: le pagine del sito che contengono il link al redirect, cioè dove si applica il fix. È il dettaglio dietro al contatore `errors_redirect` di get_audit_issues. |
| get_cwv_report | Report Core Web Vitals dell'ultimo audit: pagine campionate PSI (perf score, LCP, CLS, TBT, TTFB, dati di campo CrUX), ticket di sviluppo AI e le 10 pagine peggiori per LCP. |
| get_gsc_performance | Performance Search Console del progetto aggregata per query o pagina (click, impression, CTR, posizione media), con totali del periodo. I dati sono pre-aggregati in finestre di 7, 28 o 90 giorni: un valore diverso viene arrotondato per eccesso e la risposta riporta in `days` la finestra EFFETTIVA (`days_requested` = quella chiesta). Qui non c'è storico giorno per giorno: per datare un calo usa get_gsc_daily. |
| get_gsc_daily | Serie GIORNO PER GIORNO dei totali di sito da Search Console (click, impression, CTR, posizione media), fino a 90 giorni. È l'unico dato GSC con date reali: usalo per datare un calo o un picco, mentre get_gsc_performance dice QUALI query e pagine ma solo aggregate su finestre fisse. Totali di sito, non per pagina. `last_synced` dice fin dove arriva la serie: una coda a zero è quasi sempre un sync fermo, non un crollo. |
| get_domain_analysis | Snapshot dell'analisi della concorrenza di un dominio (authority, backlinks, keyword organiche, top keyword e pagine). Solo lettura della cache: per aggiornare usa run_domain_analysis. Senza location_code torna l'analisi più recente, qualunque mercato: il mercato effettivo è sempre nei campi location_code/language_code/market. |
| get_usage | Consumi del mese vs limiti del piano: ricerche keyword, crediti audit, crediti Presenza AI, backlink, analisi concorrenza, monitoraggi keyword e tetto azioni MCP. |
| run_keyword_research | Avvia una ricerca keyword e ritorna un job_id: richiama lo stesso tool passando job_id per avere i risultati (volume, difficulty, CPC), di solito pronti entro un paio di minuti. mode: related (da una seed), list (volumi di una lista), domain (keyword di un dominio), gap (keyword del competitor non coperte dal dominio). Con project_id marca le keyword già tracciate. Il ritiro con job_id non consuma quota. AZIONE A PAGAMENTO: consuma 1 unità della quota mensile del piano e 1 azione MCP (tetto dedicato). Usa get_usage per i crediti residui. |
| run_ai_visibility_check | Avvia in background il check di Presenza AI dei prompt del progetto (tutti gli attivi, o solo prompt_id). I risultati compaiono in get_ai_visibility dopo qualche minuto. Il tetto MCP conta 1 azione per prompt avviato. AZIONE A PAGAMENTO: consuma 1 unità della quota mensile del piano e 1 azione MCP (tetto dedicato). Usa get_usage per i crediti residui. |
| add_ai_prompt | Crea un prompt di Presenza AI e avvia il primo check. I crediti consumati dipendono dalle sources (pesi: google_aio 1, ai_mode 1, perplexity 2, chatgpt 2, gemini 6) sulla quota crediti Presenza AI del piano. AZIONE A PAGAMENTO: consuma 1 unità della quota mensile del piano e 1 azione MCP (tetto dedicato). Usa get_usage per i crediti residui. |
| run_domain_analysis | Analisi della concorrenza di un dominio: keyword organiche, traffico stimato, top keyword/pagine. I dati sono PER MERCATO (default: Italia/it) — lo stesso dominio su google.ch e su google.it dà numeri diversi. Se esiste uno snapshot più recente di 7 giorni per quel mercato lo riusa GRATIS (cached=true); altrimenti refresh (~30-60s). AZIONE A PAGAMENTO: consuma 1 unità della quota mensile del piano e 1 azione MCP (tetto dedicato). Usa get_usage per i crediti residui. |
| run_audit | Avvia un nuovo SEO Audit del progetto (crawler interno, in background: dura minuti). AZIONE A PAGAMENTO: consuma 1 azione MCP subito e, a fine crawl, crediti audit del piano pari alle pagine reali analizzate. Stato in list_projects; risultati in get_audit_overview. |
| refine_topical_architecture | Rifinisce con l'AI i cluster della Topical Architecture dell'ultimo audit (equivale a 'Rifinisci con AI' in app). UNA sola volta per audit: si riattiva con un nuovo audit SEO. Consuma 1 rifinitura AI del budget mensile del piano. AZIONE A PAGAMENTO: consuma 1 unità della quota mensile del piano e 1 azione MCP (tetto dedicato). Usa get_usage per i crediti residui. |
| generate_topical_bridge | Genera il "ponte semantico" (paragrafo con anchor, pronto da incollare) per linkare la pagina target dalla pagina source — la coppia pillar→orfana dell'Action Plan. source/target = URL (o id-nodo) di pagine dell'ultimo audit. La coppia già generata torna dalla cache GRATIS; altrimenti consuma 1 ponte AI del budget mensile (tetto 20 per audit). AZIONE A PAGAMENTO: consuma 1 unità della quota mensile del piano e 1 azione MCP (tetto dedicato). Usa get_usage per i crediti residui. |