Google arvustused

Too Google Maps hinnanguid, arvustuste arve ja hinnangute jaotusi mis tahes ettevõttele DataForSEO API abil.

Millal seda oskust kasutada

Kasuta seda oskust, kui kasutaja:

• Palub kontrollida ettevõtte Google arvustusi
• Tahab võrrelda hinnanguid mitme ettevõtte vahel
• Vajab Google arvustuste arve aruande või analüüsi jaoks
• Küsib ettevõtte Google Maps kohalolu kohta
• Tahab auditeerida konkurentide arvustusi

Tööriista asukoht

Globaalne tööriistade kataloog: ~/.agents/tools/

• Skript: ~/.agents/tools/fetch-google-reviews.js
• Mandaadid (eelistatud): AISA_ONE_API_KEY keskkonnamuutujates — proksib läbi aisa.one
• Mandaadid (varuvariant): DATAFORSEO_LOGIN ja DATAFORSEO_PASSWORD keskkonnamuutujates — otse DataForSEO-sse. Skript tuvastab automaatselt, milline on seatud.

Kasutamine

Üksik ettevõte

cd ~/.agents/tools && node fetch-google-reviews.js "Business Name" "City,Province,Country"

Näide:

cd ~/.agents/tools && node fetch-google-reviews.js "Trust Auto Sales" "Richmond,British Columbia,Canada"

Partii režiim

Loo JSON-fail ettevõtete massiiviga, seejärel käivita:

cd ~/.agents/tools && node fetch-google-reviews.js --batch /path/to/businesses.json

JSON-faili formaat:

[
  {"keyword": "Business One", "location": "Vancouver,British Columbia,Canada"},
  {"keyword": "Business Two"}
]

• keyword (kohustuslik): Otsitav ettevõtte nimi
• location (valikuline): Vaikimisi "Richmond,British Columbia,Canada"

Väljund

Üksik ettevõte (JSON)

{
  "keyword": "Trust Auto Sales",
  "title": "Trust Auto Sales",
  "rating": 4.2,
  "reviews": 677,
  "rating_distribution": {"1": 117, "2": 7, "3": 3, "4": 19, "5": 531},
  "address": "3691 Number 3 Rd, Richmond, BC V6X 2B8",
  "category": "Car dealer",
  "url": "https://trustauto.ca/"
}

Partii režiim

Prindib markdown-tabeli, millele järgneb täielik JSON:

| Business | Rating | Reviews | Address |
|----------|--------|---------|---------|
| Trust Auto Sales | 4.2 | 677 | 3691 Number 3 Rd, Richmond, BC V6X 2B8 |

Asukoha formaat

Kasuta DataForSEO asukoha formaati: City,Province/State,Country

Näited: - Richmond,British Columbia,Canada - Vancouver,British Columbia,Canada - Toronto,Ontario,Canada - New York,New York,United States

API üksikasjad

• Kasutab DataForSEO business_data/google/my_business_info/live otspunkti
• Suunab läbi aisa.one proksi (api.aisa.one/apis/v1/dataforseo/..., Bearer auth), kui AISA_ONE_API_KEY on seatud; muidu langeb otse api.dataforseo.com/v3/... peale (Basic auth)
• Sünkroonne (tagastab tulemused kohe)
• Tagastab esimese sobiva ettevõtte märksõna + asukoha jaoks
• Partii režiim lisab päringute vahele 200 ms viivituse, et vältida kiirusepiiranguid

Olulised märkused

• Kui npm install pole veel käivitatud: cd ~/.agents/tools && npm install
• Skript laadib mandaadid nii kohalikust .env-ist kui ka keskkonnamuutujatest
• DataForSEO võtab tasu iga API-kutse eest — ole suurte partiidega ettevaatlik