Dokumentáció
MCP & ChatGPT app
Csatlakoztasd a Claude-ot, a ChatGPT-t, a Cursort vagy bármely MCP-klienst az AutoPSEO 72 eszközéhez a Search Console, a GA4, a kutatás és a tartalommotor területén, bejelentkezéssel vagy API-kulccsal.
Az AutoPSEO egyetlen MCP (Model Context Protocol) szervert üzemeltet a https://app.autopseo.com/mcp címen. Bármely asszisztens csatlakozhat hozzá, amely HTTP-n keresztül beszéli az MCP-t. A csatlakozás történhet az AutoPSEO-fiókodba való bejelentkezéssel vagy egy apk_live_ API-kulccsal, és az asszisztens ugyanazokkal a property-kkel, jogosultságokkal és előfizetéssel dolgozik, mint te. A szerver 72 eszközt regisztrál három csoportban: Search Console- és GA4-riportok, kutatási adatok, valamint a tartalommotor, amelyen keresztül a saját AI-od cikkeket írhat a webhelyedhez.
Csatlakozás bejelentkezéssel
Az MCP-bejelentkezést támogató eszközökhöz nincs szükség kulcsra. Add hozzá a címet, jelentkezz be az AutoPSEO-ba, amikor az eszköz kéri, és hagyd jóvá a hozzáférést. Az eszköz ezután maga tárolja és újítja meg a hozzáférését.
- Claude Code: futtasd a
claude mcp add --transport http autopseo https://app.autopseo.com/mcpparancsot, majd írd be, hogy/mcp, válaszd ki az autopseo elemet, és kattints az Authenticate gombra. - Claude weben vagy asztali alkalmazásban: Settings → Connectors → Add custom connector, illeszd be a
https://app.autopseo.com/mcpcímet, majd kattints a Connect gombra, és jelentkezz be. - Cursor: add hozzá a szervert a
~/.cursor/mcp.json(minden projekthez) vagy a.cursor/mcp.json(egy projekthez) fájlhoz, majd használd a Cursor által mellette megjelenített Connect gombot.
{ "mcpServers": { "autopseo": { "url": "https://app.autopseo.com/mcp" } } }
Az így csatlakoztatott eszközök a MCP & API oldalon a Signed-in tools alatt jelennek meg, ahol a Sign out azonnal megszünteti a hozzáférésüket. Jó első kérés például: „Listázd a fiókomhoz tartozó Search Console property-ket." A válasz igazolja, hogy a kapcsolat működik, és megadja az asszisztensnek azokat a pontos property-neveket, amelyeket a többi eszköz elvár.
ChatGPT
A ChatGPT a fejlesztői módján keresztül csatlakozik, és a MCP & API oldal a ChatGPT app szakaszban végigvezet rajta. Röviden: a ChatGPT-ben nyisd meg a Settings → Apps & Connectors → Advanced settings részt, és kapcsold be a Developer mode beállítást (az alkalmazás a ChatGPT Plus, Pro, Business, Enterprise és Edu csomagokat sorolja fel). Válaszd a Create lehetőséget, nevezd el a csatlakozót, állítsd az MCP szerver URL-jét https://app.autopseo.com/mcp értékre, a hitelesítést pedig OAuth-ra, és jelentkezz be az AutoPSEO-ba, amikor a ChatGPT kéri. A ChatGPT csatlakozói csak OAuth-ot vagy hitelesítés nélküli működést kínálnak, ezért API-kulcsok itt nem használhatók. További részletek a ChatGPT oldalon olvashatók.
Csatlakozás API-kulccsal
A kulcsok szkriptekhez, ütemezett feladatokhoz és böngésző nélküli gépekhez valók. A MCP & API → API keys oldalon nevezd el a kulcsot, és válaszd ki a hatókörét:
- Read only: adatokat kérdezhetsz le és riportokat futtathatsz, de semmit nem adhatsz hozzá, nem módosíthatsz és nem törölhetsz.
- Read & write: mindent tud, amit a csak olvasási kulcs, emellett olyan eszközöket is, amelyek adatot módosítanak vagy kutatási kreditet használnak fel.
A teljes kulcsot, vagyis az apk_live_ előtagot és 32 hexadecimális karaktert csak egyszer jelenítjük meg, az AutoPSEO pedig kizárólag az SHA-256 hash-ét tárolja. A kulcslista megmutatja, mikor jött létre az egyes kulcsok, mikor használták őket utoljára, és hány kérést küldtek velük. A Revoke azonnal leállítja a kulcsot. Legfeljebb 25 aktív kulcsod lehet. A kulcsot Authorization: Bearer apk_live_... formában küldd el (az x-api-key fejléc is működik):
claude mcp add --transport http autopseo https://app.autopseo.com/mcp --header "Authorization: Bearer apk_live_..."
Az oldalon találsz kódrészleteket az OpenAI Responses API-hoz, nyers JSON-RPC-hez curl-lel (a szerver a Streamable HTTP transportot használja), valamint a https://app.autopseo.com/v1 címen elérhető REST API-hoz. Ez a 19 Search Console- és GA4-eszközt kínálja ugyanazokkal a kulcsokkal, és egy OpenAPI 3.1 dokumentumot a /v1/openapi.json címen.
Az eszközök
A MCP & API oldal mindig a naprakész eszköznevekkel szolgál. Az oldal írásakor 72 eszköz volt.
Search Console és GA4 (19 eszköz)
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 és ga4_key_events. Ezek nem fogyasztanak krediteket. Dátumok megadása nélkül az utolsó 28 lezárt napot hasonlítják össze a megelőző 28 nappal, és bárki kipróbálhatja őket a sc-domain:demo.autopseo.app demo property-n. A nevével ellentétben a content_decay ebbe a csoportba tartozik: azokat az oldalakat keresi meg, amelyek kattintásokat veszítenek.
Kutatás (33 eszköz)
- Fiók és projektek:
whoami,create_project,get_project_context,update_project_context - Kulcsszavak:
research_keywords,get_keyword_metrics,get_ranked_keywords,get_domain_keyword_suggestions,save_keywords,list_saved_keywords - Domainek, találati oldalak és linkek:
get_domain_overview,get_serp_results,find_serp_competitors,get_backlinks_overview,get_backlinks_profile - Rangsorkövetés:
create_rank_tracker,get_rank_tracker,add_rank_tracking_keywords,remove_rank_tracking_keywords,estimate_rank_tracker_cost,run_rank_tracker - Helyi keresés:
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 - Webhelyauditok:
run_site_audit,get_audit_status,get_audit_issues,get_audit_pages
Ezek közül sok eszköz a DataForSEO-tól vásárol adatot, és a kutatási kreditjeidet terheli, ezért a kéréseidet tartsd fókuszáltan, nagyobb kötegek előtt pedig ellenőrizd a költséget.
Tartalommotor (20 eszköz)
Ezekkel a saját AI-od ugyanabban a sorban dolgozhat, mint az AutoPSEO íróprogramja: 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 és content_remove_path. A szerver öt promptot is kínál: write-articles, optimize-page, revise-draft, connect-repo és refresh-decayed.
Egy tipikus munkamenetben kilistázod a feladatokat, lefoglalsz egyet (a foglalás két órán át tartja), elolvasod a brief-et, írsz, beküldöd, kijavítod, amit az ellenőrzések visszaküldenek, és csak akkor publikálsz, ha te azt mondod. A borítóképekhez és a fordításokhoz külön eszközök tartoznak. Az így írt cikkek ugyanazokon az ellenőrzéseken mennek át, mint az AutoPSEO sajátjai, és nem használják a cikkkeretedet, bár a brief első lekérése az élő keresési találatokat kutatási kreditekből olvassa be. A teljes folyamatot a Írás a saját AI-oddal oldal írja le.
Olvasási, írási és fizetős eszközök
Minden eszköznek van hozzáférési osztálya. A read eszközök csak megnéznek valamit (33 ilyen van), a write eszközök módosítják a munkaterületedet (22), a paid eszközök pedig csak olvasnak, de kutatási adatot vásárolnak (17). A csak olvasási kulcs kizárólag read eszközöket hívhat. A Read hozzáférésű csapattag szintén csak read eszközöket hívhat, bármelyik kulccsal vagy bejelentkezéssel dolgozzon is, és minden tag csak azokat a property-ket éri el, amelyeket a meghívója megnevez (Megosztás és csapathozzáférés).
Korlátok és hibák
A hívások száma kulcsonként percenként 60-ra, fiókonként óránként 1,000-re van korlátozva, az összes kulcsot együtt számolva. Bármelyik korlát átlépésekor a szerver HTTP 429 kóddal és Retry-After fejléccel válaszol, és a legtöbb kliens magától vár, majd újrapróbálkozik. Az initialize és a ping kézfogás nem számít bele. Ha a próbaidőszak előfizetés nélkül ér véget, az eszközök „subscription required" üzenettel válaszolnak. Az asszisztens szolgáltatója csak az általad indított kérésekhez kapja meg az adataidat. Ennek megszüntetéséhez jelentkeztesd ki az eszközt, vagy vond vissza a kulcsát. További példák a Search Console MCP oldalon találhatók.