Documentație
MCP & ChatGPT app
Conectează Claude, ChatGPT, Cursor sau orice client MCP la cele 72 de instrumente AutoPSEO pentru Search Console, GA4, cercetare și motorul de conținut, prin autentificare sau cu o cheie API.
AutoPSEO rulează un singur server MCP (Model Context Protocol) la adresa https://app.autopseo.com/mcp. Orice asistent care vorbește MCP prin HTTP se poate conecta, fie autentificându-se în contul tău AutoPSEO, fie cu o cheie API apk_live_, și lucrează apoi cu aceleași proprietăți, permisiuni și același plan ca tine. Serverul înregistrează 72 de instrumente în trei grupuri: rapoarte Search Console și GA4, date de cercetare și motorul de conținut, prin care propriul tău AI poate scrie articole pentru site-ul tău.
Conectare prin autentificare
Instrumentele care acceptă autentificarea MCP nu au nevoie de cheie. Adaugă adresa, autentifică-te în AutoPSEO când ți se cere și aprobă accesul; instrumentul își păstrează și își reînnoiește apoi singur accesul.
- Claude Code: rulează
claude mcp add --transport http autopseo https://app.autopseo.com/mcp, apoi scrie/mcp, alege autopseo și selectează Authenticate. - Claude pe web sau desktop: Settings → Connectors → Add custom connector, lipește
https://app.autopseo.com/mcp, apoi apasă Connect și autentifică-te. - Cursor: adaugă serverul în
~/.cursor/mcp.json(toate proiectele) sau în.cursor/mcp.json(un singur proiect), apoi folosește butonul Connect pe care Cursor îl afișează lângă el.
{ "mcpServers": { "autopseo": { "url": "https://app.autopseo.com/mcp" } } }
Fiecare instrument conectat astfel apare la Signed-in tools pe pagina MCP & API, unde Sign out îi taie accesul imediat. O primă cerere potrivită este „Listează proprietățile Search Console din contul meu": răspunsul dovedește că conexiunea funcționează și îi oferă asistentului numele exacte ale proprietăților pe care le așteaptă celelalte instrumente.
ChatGPT
ChatGPT se conectează prin modul pentru dezvoltatori, iar pagina MCP & API îl descrie pas cu pas la ChatGPT app. Pe scurt: în ChatGPT, deschide Settings → Apps & Connectors → Advanced settings și activează Developer mode (aplicația menționează ChatGPT Plus, Pro, Business, Enterprise și Edu), alege Create, dă un nume conectorului, setează adresa serverului MCP la https://app.autopseo.com/mcp și autentificarea la OAuth, apoi autentifică-te în AutoPSEO când îți cere ChatGPT. Conectorii ChatGPT oferă doar OAuth sau lipsa autentificării, deci cheile API nu funcționează acolo. Găsești mai multe detalii pe pagina ChatGPT.
Conectare cu o cheie API
Cheile sunt pentru scripturi, sarcini programate și mașini fără browser. La MCP & API → API keys, dă un nume cheii și alege domeniul de acces:
- Read only: interoghează date și rulează rapoarte; nu poate adăuga, modifica sau șterge nimic.
- Read & write: tot ce face o cheie de citire, plus instrumentele care modifică date sau consumă credite de cercetare.
Cheia completă, apk_live_ urmat de 32 de caractere hexazecimale, este afișată o singură dată; AutoPSEO stochează doar hash-ul ei SHA-256. Lista de chei arată când a fost creată fiecare cheie, când a fost folosită ultima dată și câte cereri a făcut, iar Revoke oprește imediat o cheie. Poți avea cel mult 25 de chei active. Trimite cheia ca Authorization: Bearer apk_live_... (funcționează și un antet x-api-key):
claude mcp add --transport http autopseo https://app.autopseo.com/mcp --header "Authorization: Bearer apk_live_..."
Pagina conține și fragmente de cod pentru OpenAI Responses API, pentru JSON-RPC direct cu curl (serverul folosește transportul Streamable HTTP) și pentru REST API la https://app.autopseo.com/v1, care expune cele 19 instrumente Search Console și GA4 cu aceleași chei și un document OpenAPI 3.1 la /v1/openapi.json.
Instrumentele
Pagina MCP & API listează întotdeauna numele curente ale instrumentelor; la momentul scrierii acestei pagini erau 72.
Search Console și GA4 (19 instrumente)
list_properties, search_analytics, top_queries, top_pages, top_countries, compare_periods, content_decay, cannibalization, ctr_benchmark, page_poaching, rank_changes, new_lost_rankings, url_inspection, sitemaps, annotations, create_annotation, ga4_overview, ga4_breakdown și ga4_key_events. Nu consumă credite. Dacă nu primesc date calendaristice, acoperă ultimele 28 de zile consolidate, comparativ cu cele 28 dinaintea lor, iar oricine le poate încerca pe proprietatea demo sc-domain:demo.autopseo.app. În ciuda numelui, content_decay aparține acestui grup: găsește paginile care pierd clicuri.
Cercetare (33 de instrumente)
- Cont și proiecte:
whoami,create_project,get_project_context,update_project_context - Cuvinte cheie:
research_keywords,get_keyword_metrics,get_ranked_keywords,get_domain_keyword_suggestions,save_keywords,list_saved_keywords - Domenii, pagini de rezultate și linkuri:
get_domain_overview,get_serp_results,find_serp_competitors,get_backlinks_overview,get_backlinks_profile - Urmărirea pozițiilor:
create_rank_tracker,get_rank_tracker,add_rank_tracking_keywords,remove_rank_tracking_keywords,estimate_rank_tracker_cost,run_rank_tracker - Căutare locală:
search_local_businesses,get_local_serp_results,get_local_rank_grid,get_business_profile,get_business_reviews,get_business_updates,get_google_business_questions,list_business_categories - Audituri de site:
run_site_audit,get_audit_status,get_audit_issues,get_audit_pages
Multe dintre acestea cumpără date de la DataForSEO și consumă din creditele tale de cercetare, așa că formulează cereri concentrate și verifică înainte de loturi mari.
Motorul de conținut (20 de instrumente)
Acestea permit propriului tău AI să lucreze prin aceeași coadă ca scriitorul AutoPSEO: content_list_tasks, content_claim, content_get_brief, content_submit, content_publish, content_unpublish, content_get_page, content_report, content_find_pages, content_add_topics, content_decline, content_merge, content_cover, content_set_cover, content_get_translation, content_submit_translation, content_instructions, content_propose_value, content_submit_value și content_remove_path. Serverul oferă și cinci prompturi: write-articles, optimize-page, revise-draft, connect-repo și refresh-decayed.
O sesiune tipică listează sarcinile, rezervă una (o rezervare o ține două ore), citește brief-ul, scrie, trimite și corectează tot ce îi returnează verificările, iar publică doar când spui tu. Imaginile de copertă și traducerile au instrumente proprii. Articolele scrise astfel trec aceleași verificări ca cele AutoPSEO și nu consumă nimic din cota ta de articole, deși primul apel pentru un brief citește rezultatele live ale căutării pe credite de cercetare. Întregul flux este descris în Scrie cu propriul tău AI.
Instrumente de citire, de scriere și cu plată
Fiecare instrument are o clasă de acces. Instrumentele read doar consultă (33 dintre ele), instrumentele write modifică spațiul tău de lucru (22), iar instrumentele paid doar citesc, dar cumpără date de cercetare (17). O cheie doar pentru citire poate apela numai instrumente read. Un membru al echipei cu acces Read poate apela, de asemenea, numai instrumente read, indiferent de cheia sau autentificarea folosită, iar fiecare membru ajunge doar la proprietățile numite în invitația sa (Partajare și acces pentru echipă).
Limite și erori
Apelurile sunt limitate la 60 pe minut per cheie și la 1,000 pe oră per cont, însumate pentru toate cheile sale. Peste oricare dintre limite, serverul răspunde cu HTTP 429 și un antet Retry-After, iar majoritatea clienților așteaptă și reîncearcă singuri; handshake-urile initialize și ping nu se numără. După ce o perioadă de probă se încheie fără abonament, instrumentele răspund „subscription required". Furnizorul unui asistent primește datele tale doar pentru cererile pe care le faci; deconectează un instrument sau revocă-i cheia pentru a opri accesul. Mai multe exemple găsești pe pagina Search Console MCP.