DataForSEO: reaalajas SEO-andmed (laiendus)

Reaalajas otsinguandmed DataForSEO MCP-serveri kaudu. Pakub reaalajas SERP-tulemusi (orgaanilised + pildid), märksõnameetrikaid, tagasilinkide profiile, lehesisest analüüsi, sisuanalüüsi, ärikirjeid, AI-nähtavuse kontrolli ja LLM-mainimiste jälgimist 9 API-mooduli ja 79+ MCP-tööriista kaudu.

Eeldused

See oskus nõuab DataForSEO laienduse paigaldamist:

./extensions/dataforseo/install.sh

Kontrolli saadavust: enne mis tahes DataForSEO tööriista kasutamist veendu, et MCP-server on ühendatud, kontrollides, kas serp_organic_live_advanced või mõni muu DataForSEO tööriist on saadaval. Kui tööriistu pole, teavita kasutajat, et laiendus pole paigaldatud, ja anna paigaldusjuhised.

API-krediidi teadlikkus

DataForSEO võtab tasu iga API-kutse eest. Ole tõhus: - Eelista hulgipäringu otspunkte mitmele üksikkutsele - Kasuta vaikeparameetreid (US, inglise keel), kui kasutaja ei määra teisiti - Hoia tulemusi seansi jooksul meeles; ära küsi samu andmeid uuesti - Hoiata kasutajat enne kulukate toimingute käivitamist (täielikud tagasilinkide roomamised, suured märksõnaloendid)

Kulupiirangud

Enne iga DataForSEO MCP-kutset tee kuluhinnang:

"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_costs.py check <endpoint> [--count N]

• Kui "status": "approved" → jätka API-kutsega
• Kui "status": "needs_approval" → näita kasutajale kuluhinnangut ja küsi enne jätkamist kinnitust
• Kui "status": "blocked" → teavita kasutajat, et päevane eelarvelimiit ületataks; ÄRA jätka

Pärast iga API-kutse lõppu logi kulu:

"${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo" run dataforseo_costs.py log <endpoint> <actual_cost>

Kasutaja käsud kuluhalduseks: - /seo dataforseo costs today → näita tänaste kulutuste jaotust - /seo dataforseo costs summary → näita 7 päeva kulutuste ajalugu - /seo dataforseo costs config --mode threshold --threshold 0.50 → seadista kinnitusrežiim

Laadi references/cost-tiers.md täieliku hinnatabeli, eelarve eelseadistuste ja kulude vähendamise nõuannete jaoks.

Kiirviide

Käsk	Mida see teeb
/seo dataforseo serp <keyword>	Google'i orgaanilised SERP-tulemused
/seo dataforseo serp-images <keyword>	Google Images SERP-tulemused
/seo dataforseo serp-youtube <keyword>	YouTube'i otsingutulemused
/seo dataforseo youtube <video_id>	YouTube'i video süvaanalüüs
/seo dataforseo keywords <seed>	Märksõnaideed ja -soovitused
/seo dataforseo volume <keywords>	Märksõnade otsingumaht
/seo dataforseo difficulty <keywords>	Märksõnade raskusskoorid
/seo dataforseo intent <keywords>	Otsingukavatsuse klassifitseerimine
/seo dataforseo trends <keyword>	Google Trendsi andmed
/seo dataforseo backlinks <domain>	Täielik tagasilinkide profiil
/seo dataforseo competitors <domain>	Konkurentdomeenide analüüs
/seo dataforseo ranked <domain>	Domeeni järjestuvad märksõnad
/seo dataforseo intersection <domains>	Märksõnade/tagasilinkide kattuvus
/seo dataforseo traffic <domains>	Liikluse hulgihinnang
/seo dataforseo subdomains <domain>	Alamdomeenid koos järjestusandmetega
/seo dataforseo top-searches <domain>	Populaarseimad päringud, mis domeeni mainivad
/seo dataforseo onpage <url>	Lehesisene analüüs (Lighthouse + parsimine)
/seo dataforseo tech <domain>	Tehnoloogiapinu tuvastamine
/seo dataforseo whois <domain>	WHOIS-registreerimisandmed
/seo dataforseo content <keyword/url>	Sisuanalüüs ja trendid
/seo dataforseo listings <keyword>	Ärikirjete otsing
/seo dataforseo ai-scrape <query>	ChatGPT veebikraapija GEO jaoks
/seo dataforseo ai-mentions <keyword>	LLM-mainimiste jälgimine GEO jaoks

---

SERP-analüüs

/seo dataforseo serp <keyword>

Too reaalajas Google'i orgaanilised otsingutulemused.

MCP-tööriistad: serp_organic_live_advanced

Vaikeparameetrid: location_code=2840 (US), language_code=en, device=desktop, depth=100

Toetab ka: tööriist serp_organic_live_advanced toetab parameetri se kaudu Google'it, Bingi ja Yahood. Otsingumootori vahetamiseks määra „bing“ või „yahoo“.

Väljund: positsioon, URL, pealkiri, kirjeldus, domeen, esiletõstetud lõigud (featured snippets), AI-ülevaate viited, People Also Ask.

/seo dataforseo serp-youtube <keyword>

Too YouTube'i otsingutulemused. Väärtuslik GEO jaoks. YouTube'i mainimised on AI-tsitaatidega kõige tugevamas korrelatsioonis.

MCP-tööriistad: serp_youtube_organic_live_advanced

Väljund: video pealkiri, kanal, vaatamised, üleslaadimise kuupäev, kirjeldus, URL.

/seo dataforseo youtube <video_id>

Konkreetse YouTube'i video süvaanalüüs: info, kommentaarid ja subtiitrid. Mõned kolmandate osapoolte uuringud näitavad YouTube'i mainimiste ja AI-nähtavuse vahel korrelatsiooni 0,737, seega käsitle seda metoodikast sõltuva GEO-signaalina.

MCP-tööriistad: serp_youtube_video_info_live_advanced, serp_youtube_video_comments_live_advanced, serp_youtube_video_subtitles_live_advanced

Parameetrid: video_id (YouTube'i video ID, nt „dQw4w9WgXcQ“)

Väljund: video metaandmed (pealkiri, kanal, vaatamised, meeldimised, kirjeldus), populaarseimad kommentaarid koos kaasatusega, subtiitrite/transkriptsiooni tekst.

/seo dataforseo serp-images <keyword>

Too reaalajas Google Images otsingutulemused. Vaata, millised pildid märksõnale järjestuvad, millised domeenid pilditulemustes domineerivad, ja tuvasta visuaalse sisu võimalused.

MCP-tööriistad: serp_google_images_live_advanced

Vaikeparameetrid: location_code=2840 (US), language_code=en, device=desktop, depth=100

Parameetrid: keyword (kohustuslik), depth (valikuline, max 700, arveldatakse iga 100 tulemuse kaupa), search_param (valikuline, nt „site:example.com“)

Kuluhoiatus: operaatorite site: või filetype: kasutamine toob kaasa 5-kordse API-kulu. Hoiata kasutajat enne filtreeritud päringute käivitamist.

Väljund: positsioon, pealkiri, alt-tekst, lähtelehe URL, otsene pildi URL, domeen, kodeeritud URL.

Esitatav analüüs: - Domeenide domineerimine: millistele saitidele kuulub kõige rohkem pildipositsioone (top 10 domeeni arvu järgi) - Alt-teksti mustrid: levinud pealkirja/alt-teksti mustrid kõrgeima järjestusega piltides - Vormingute jaotus: WebP vs JPEG vs PNG tipptulemustes (tuleta image_url laiendist) - Võimaluste tuvastamine: märksõnad, mille puhul kasutajal on orgaanilised positsioonid, kuid puudub pildikohalolu

---

Märksõnauuring

/seo dataforseo keywords <seed>

Genereeri lähtemärksõnast märksõnaideid, -soovitusi ja seotud termineid.

MCP-tööriistad: dataforseo_labs_google_keyword_ideas, dataforseo_labs_google_keyword_suggestions, dataforseo_labs_google_related_keywords

Vaikeparameetrid: location_code=2840 (US), language_code=en, limit=50

Väljund: märksõna, otsingumaht, CPC, konkurentsitase, märksõna raskus, trend.

/seo dataforseo volume <keywords>

Hangi märksõnaloendi otsingumaht ja meetrikad.

MCP-tööriistad: kw_data_google_ads_search_volume

Parameetrid: keywords (massiiv, komadega eraldatud), location_code, language_code

Väljund: märksõna, igakuine otsingumaht, CPC, konkurents, igakuised trendiandmed.

/seo dataforseo difficulty <keywords>

Arvuta märksõnade raskusskoorid järjestuskonkurentsi hindamiseks.

MCP-tööriistad: dataforseo_labs_bulk_keyword_difficulty

Parameetrid: keywords (massiiv), location_code, language_code

Väljund: märksõna, raskusskoor (0–100), tõlgendus (Easy/Medium/Hard/Very Hard).

/seo dataforseo intent <keywords>

Klassifitseeri märksõnad kasutaja otsingukavatsuse järgi.

MCP-tööriistad: dataforseo_labs_search_intent

Parameetrid: keywords (massiiv), location_code, language_code

Väljund: märksõna, kavatsuse tüüp (informational, navigational, commercial, transactional), usaldusskoor.

/seo dataforseo trends <keyword>

Analüüsi märksõnade trende ajas Google Trendsi andmete abil.

MCP-tööriistad: kw_data_google_trends_explore

Parameetrid: keywords (massiiv), location_code, date_from, date_to, language_code

Väljund: märksõna, aegridade andmed, trendi suund, hooajalisuse signaalid.

---

Domeeni- ja konkurentide analüüs

/seo dataforseo backlinks <domain>

Põhjalik tagasilinkide profiili analüüs.

MCP-tööriistad: backlinks_summary, backlinks_backlinks, backlinks_anchors, backlinks_referring_domains, backlinks_bulk_spam_score, backlinks_timeseries_summary

Vaikeparameetrid: limit=100 iga alamkutse kohta

Väljund: tagasilinke kokku, viitavad domeenid, domeeni reiting, rämpsposti skoor, populaarseimad ankrutekstid, uued/kaotatud tagasilingid ajas, dofollow-suhe, populaarseimad viitavad domeenid.

/seo dataforseo competitors <domain>

Tuvasta konkureerivad domeenid ja hinda liiklust.

MCP-tööriistad: dataforseo_labs_google_competitors_domain, dataforseo_labs_google_domain_rank_overview, dataforseo_labs_bulk_traffic_estimation

Väljund: konkurentdomeenid, märksõnade kattuvus %, hinnanguline liiklus, domeeni reiting, ühised märksõnad.

/seo dataforseo ranked <domain>

Loetle märksõnad, millele domeen järjestub, koos positsioonide ja lehe andmetega.

MCP-tööriistad: dataforseo_labs_google_ranked_keywords, dataforseo_labs_google_relevant_pages

Vaikeparameetrid: limit=100, location_code=2840

Väljund: märksõna, positsioon, URL, otsingumaht, liikluse osakaal, SERP-funktsioonid.

/seo dataforseo intersection <domain1> <domain2> [...]

Leia ühised märksõnad ja tagasilinkide allikad 2–20 domeeni vahel.

MCP-tööriistad: dataforseo_labs_google_domain_intersection, backlinks_domain_intersection

Parameetrid: domains (massiiv, 2–20)

Väljund: ühised märksõnad koos positsioonidega domeeniti, ühised tagasilinkide allikad, domeenipõhised unikaalsed märksõnad.

/seo dataforseo traffic <domains>

Hinda ühe või mitme domeeni orgaanilist otsinguliiklust.

MCP-tööriistad: dataforseo_labs_bulk_traffic_estimation

Parameetrid: domains (massiiv)

Väljund: domeen, hinnanguline orgaaniline liiklus, liikluse hinnanguline väärtus, populaarseimad märksõnad.

/seo dataforseo subdomains <domain>

Loetle alamdomeenid koos nende järjestusandmete ja liiklushinnangutega.

MCP-tööriistad: dataforseo_labs_google_subdomains

Parameetrid: target (domeen), location_code, language_code

Väljund: alamdomeen, järjestuvate märksõnade arv, hinnanguline liiklus, orgaaniline väärtus.

/seo dataforseo top-searches <domain>

Leia populaarseimad otsingupäringud, mille tulemustes konkreetset domeeni mainitakse.

MCP-tööriistad: dataforseo_labs_google_top_searches

Parameetrid: target (domeen), location_code, language_code

Väljund: päring, otsingumaht, domeeni positsioon, SERP-funktsioonid, liikluse osakaal.

---

Tehniline / lehesisene

/seo dataforseo onpage <url>

Käivita lehesisene analüüs, sh Lighthouse'i audit ja sisu parsimine.

MCP-tööriistad: on_page_instant_pages, on_page_content_parsing, on_page_lighthouse

Kasutus: - on_page_instant_pages: kiire lehe analüüs (olekukoodid, metasildid, sisu maht, lehe ajastus, katkised lingid, lehesisesed kontrollid) - on_page_content_parsing: lehe sisu väljavõtmine ja parsimine (lihttekst, sõnade arv, struktuur) - on_page_lighthouse: täielik Lighthouse'i audit (jõudlusskoor, ligipääsetavus, parimad tavad, SEO, Core Web Vitals)

Väljund: roomatud lehed, olekukoodid, metasildid, pealkirjad, sisu maht, laadimisajad, Lighthouse'i skoorid, katkised lingid, ressursside analüüs.

/seo dataforseo tech <domain>

Tuvasta domeenil kasutatavad tehnoloogiad.

MCP-tööriistad: domain_analytics_technologies_domain_technologies

Väljund: tehnoloogia nimi, versioon, kategooria (CMS, analüütika, CDN, raamistik jne).

/seo dataforseo whois <domain>

Hangi WHOIS-registreerimisandmed.

MCP-tööriistad: domain_analytics_whois_overview

Väljund: registripidaja, loomiskuupäev, aegumiskuupäev, nimeserverid, registreerija andmed (kui avalikud).

---

Sisu- ja äriandmed

/seo dataforseo content <keyword/url>

Analüüsi sisu kvaliteeti, otsi sisu teema järgi ja jälgi fraaside trende.

MCP-tööriistad: content_analysis_search, content_analysis_summary, content_analysis_phrase_trends

Parameetrid: keyword (otsingu/trendide jaoks) või URL (kokkuvõtte jaoks)

Väljund: sisuvasted koos kvaliteediskooridega, meelestatuse analüüs, loetavusmeetrikad, fraaside trendiandmed ajas.

/seo dataforseo listings <keyword>

Otsi ärikirjeid kohaliku SEO konkurentsianalüüsi jaoks.

MCP-tööriistad: business_data_business_listings_search

Parameetrid: keyword, location (valikuline)

Väljund: ettevõtte nimi, kirjeldus, kategooria, aadress, telefon, domeen, hinnang, arvustuste arv, kinnitatud omandi staatus.

---

AI-nähtavus / GEO

/seo dataforseo ai-scrape <query>

Kraabi, mida ChatGPT veebiotsing päringule tagastab. ChatGPT nähtavuse kontroll: vaata, milliseid allikaid ChatGPT sinu sihtmärksõnade puhul tsiteerib. Kontrolli Google AI Overviews'i ja AI Mode'i GSC gen-AI aruannetega, kui need on saadaval.

MCP-tööriistad: ai_optimization_chat_gpt_scraper

Parameetrid: query, location_code (valikuline), language_code (valikuline). Saadaolevate asukohtade leidmiseks kasuta ai_optimization_chat_gpt_scraper_locations.

Väljund: ChatGPT vastuse sisu, tsiteeritud allikad/URL-id, viidatud domeenid.

/seo dataforseo ai-mentions <keyword>

Jälgi, kuidas LLM-id brände, domeene ja teemasid mainivad. GEO jaoks kriitiline. Mõõdab tegelikku AI-nähtavust mitmel LLM-platvormil.

MCP-tööriistad: ai_opt_llm_ment_search, ai_opt_llm_ment_top_domains, ai_opt_llm_ment_top_pages, ai_opt_llm_ment_agg_metrics

Parameetrid: keyword, location_code (valikuline), language_code (valikuline). Saadaolevate asukohtade/keelte jaoks kasuta ai_opt_llm_ment_loc_and_lang ja toetatud LLM-mudelite jaoks ai_optimization_llm_models.

Töövoog: 1. Otsi LLM-mainimisi tööriistaga ai_opt_llm_ment_search (leia brändi/märksõna mainimised LLM-vastustes) 2. Hangi enim tsiteeritud domeenid tööriistaga ai_opt_llm_ment_top_domains (millised domeenid on selle teema puhul enim tsiteeritud) 3. Hangi enim tsiteeritud lehed tööriistaga ai_opt_llm_ment_top_pages (millised konkreetsed lehed on enim tsiteeritud) 4. Hangi koondmeetrikad tööriistaga ai_opt_llm_ment_agg_metrics (mainimiste üldmaht, trendid)

Väljund: LLM-mainimiste arv, enim tsiteeritud domeenid koos sagedusega, enim tsiteeritud lehed, mainimiste trendid ajas, platvormideülesed nähtavusskoorid.

Edasijõudnutele: kasuta ai_opt_llm_ment_cross_agg_metrics mudelitevaheliseks võrdluseks (kuidas mainimised erinevad ChatGPT, Claude'i, Perplexity jt vahel).

---

Saadaolevad abitööriistad

Täiendavad DataForSEO MCP-tööriistad on saadaval sisekasutuseks, kuid neil pole eraldi käske. Laadi references/tool-catalog.md, kui pead leidma konkreetse abitööriista (asukohtade otsing, hulgitoimingud, ajaloolised andmed, filtrivalikud).

Oskustevaheline integratsioon

Kui DataForSEO MCP-tööriistad on saadaval, saavad teised claude-seo oskused kasutada reaalajas andmeid:

• seo-audit: käivita agent seo-dataforseo päris SERP-, tagasilinkide, lehesiseste ja ärikirjete andmete jaoks
• seo-technical: kasuta on_page_instant_pages / on_page_lighthouse päris roomamisandmete jaoks ja domain_analytics_technologies_domain_technologies tehnoloogiapinu tuvastamiseks
• seo-content: kasuta kw_data_google_ads_search_volume, dataforseo_labs_bulk_keyword_difficulty, dataforseo_labs_search_intent päris märksõnameetrikate jaoks ja content_analysis_summary sisu kvaliteedi jaoks
• seo-page: kasuta serp_organic_live_advanced päris SERP-positsioonide jaoks ja backlinks_summary linkide andmete jaoks
• seo-images: kasuta serp_google_images_live_advanced konkurentide pildi-SERP-i andmete jaoks ja võrdle lehesisese pildiauditiga
• seo-geo: kasuta ai_optimization_chat_gpt_scraper päris ChatGPT nähtavuse jaoks ja ai_opt_llm_ment_search LLM-mainimiste jälgimiseks
• seo-plan: kasuta dataforseo_labs_google_competitors_domain, dataforseo_labs_google_domain_intersection, dataforseo_labs_bulk_traffic_estimation päris konkurentsiteabe jaoks

Vigade käsitlemine

• MCP-server pole ühendatud: teata, et DataForSEO laiendus pole paigaldatud või MCP-server pole kättesaadav. Soovita käivitada ./extensions/dataforseo/install.sh
• API autentimine ebaõnnestus: teata kehtetutest mandaatidest. Soovita kontrollida DataForSEO API kasutajanime/parooli MCP-konfiguratsioonis
• Päringulimiit ületatud: teata limiidi täitumisest ja soovita enne uuesti proovimist oodata
• Tulemusi ei tagastatud: teata päringu kohta „andmeid ei leitud“, selle asemel et oletada. Soovita päringut laiendada või kontrollida asukoha-/keelekoode
• Kehtetu asukohakood: teata veast ja soovita õige koodi leidmiseks kasutada asukohtade otsingutööriista

Väljundi vormindamine

Järgi olemasolevaid claude-seo väljundimustreid: - Kasuta võrdlusandmete jaoks tabeleid - Prioritiseeri probleemid järjekorras Critical > High > Medium > Low - Lisa konkreetsed, rakendatavad soovitused - Näita skoore kujul XX/100, kus asjakohane - Märgi andmeallikaks „DataForSEO (live)“, et eristada staatilisest analüüsist