---
title: Whitesparki tööriist
description: Viidete lünkade analüüs, viidete loomine ja arvustuste kampaaniad Whitesparki abil.
category: Marketing
sublabel: Kohalik SEO
author: garrettjsmith
tags: 
license: MIT
source: https://github.com/garrettjsmith/localseoskills
---

# Whitespark Tool

> **Märkus:** Local SEO Data (`localseodata-tool`) katab nüüd tsitaadiauditid `citation_audit` kaudu. Kasuta tsitaadiandmete jaoks vaikimisi Local SEO Data'd. Whitespark jääb eelistatud tööriistaks tsitaatide ehitamiseks, positsiooni jälgimiseks ja arvustuste genereerimise kampaaniateks (Reputation Builder).

Whitesparkil EI OLE MCP-serverit. Kaks selle toodet pakuvad nüüd REST API-sid — Local Rank Tracker ja Local Ranking Grids (geovõrgud), mõlemad beetas — nii et agent saab positsiooni- ja võrguandmeid nende jaoks otse tõmmata. Selle tsitaaditoodetel API-t pole ja need jäävad töölaua-/hallatavaks, nii et tsitaatide puhul on agendi roll juhendada, mida Whitesparkis teha, ja tõlgendada kasutaja esitatud andmeid. Vaata allpool Whitesparki API-de sektsiooni.

## Millal kasutada Whitesparki vs teisi tööriistu

| Sa vajad | Kasuta Whitesparki | Kasuta hoopis |
|----------|---------------|-------------|
| Tsitaadilünkade analüüs (konkurent vs sina) | ✅ Local Citation Finder | BrightLocal (teeb ka seda, on MCP) |
| Hallatud tsitaatide ehitamine (sinu eest tehtud) | ✅ Parima kvaliteediga teenus | BrightLocal (pakub ka seda) |
| Arvustuste genereerimise kampaaniad (e-post/SMS) | ✅ Reputation Builder | — |
| Arvustuste jälgimine | ✅ | BrightLocal (on MCP, võib olla parem agendi ligipääsuks) |
| Kohaliku positsiooni jälgimine | ✅ | Local SEO Data, Local Falcon (geovõrk on kohaliku jaoks parem) |
| Tsitaadi täpsuse audit | ⚠️ Saab teha | BrightLocal (parem NAP-täpsuse hindamiseks) |
| Märksõnauuring | ❌ | Local SEO Data, Semrush, Ahrefs |
| Tagasilinkide analüüs | ❌ | Local SEO Data, Ahrefs |
| Tehniline audit | ❌ | Screaming Frog |
| Geovõrgu positsioonid | ✅ | Local SEO Data, Local Falcon |

## Whitespark vs BrightLocal

Need kaks kattuvad oluliselt. Siin on, millal kumbagi kasutada:

| Funktsioon | Whitespark | BrightLocal |
|---------|-----------|-------------|
| Tsitaatide ehitamise kvaliteet | ✅ Kõrgem kvaliteet (käsitsi ülevaatus) | Hea, kuid automatiseeritum |
| Tsitaadilünkade leidja | ✅ Põhjalikum | ✅ Samuti hea |
| NAP-täpsuse hindamine | Põhiline | ✅ Parem hindamissüsteem |
| MCP-server saadaval | ❌ Ei | ✅ Jah |
| Arvustuste genereerimine | ✅ Reputation Builder | ✅ On ka see |
| Valge sildiga aruanded | Põhiline | ✅ Parem aruandlus |
| Maine tööstuses | ✅ Tsitaadispetsialistid | ✅ Kõik-ühes kohalik SEO |
| Hinnastamine | Teenusepõhine | Tellimus |

**Soovitus:** kui MCP-ühenduvus loeb (agent saab andmeid otse tõmmata), kasuta BrightLocal'i. Kui prioriteet on tsitaatide ehitamise kvaliteet ja kasutaja on nõus töölauda kasutama, on Whitesparki hallatav teenus suurepärane.

## Põhitöövood

### Tsitaadilünkade analüüs

**Millal:** kasutaja soovib leida katalooge, kus konkurendid on loetletud, aga tema mitte.

**Mida Whitesparkis teha:**
1. Käivita Local Citation Finder sihtettevõtte JA 2–3 konkurendi jaoks
2. Võrdle tsitaadiallikaid kõigi ettevõtete lõikes
3. Tuvasta kataloogid, kus konkurendid esinevad, aga kasutaja mitte

**Mida agent saab teha:**
- Juhendada kasutajat, milliseid konkurente kontrollida
- Tõlgendada tsitaadilünkade aruannet, kui kasutaja tulemusi jagab
- Prioriteerida, milliseid katalooge esimesena sihtida

**Tsitaatide prioriteedi raamistik:**
1. **1. tase** (kohustuslik): Google, Apple, Bing, Yelp, Facebook, andmekoondajad
2. **2. tase** (oluline): tööstuspõhised kataloogid (Healthgrades, Avvo, Angi jne)
3. **3. tase** (hea omada): kohalikud kataloogid, kaubanduskoda, BBB
4. **4. tase** (madal prioriteet): üldised veebikataloogid, nišisaidid

### Hallatud tsitaatide ehitamine

**Millal:** tsitaadilüngad tuvastatud ja kasutaja soovib abi nende ehitamisel.

**Mida Whitespark teeb:**
- Käsitsi esitamine kataloogidesse (kõrgem kvaliteet kui automatiseeritud tööriistadel)
- Kontroll, et kirjed on avaldatud ja täpsed
- Pideva hoolduse valikud

**Mida kasutajale öelda:**
1. Esita täpne NAP (peab GBP-ga kattuma)
2. Esita ettevõtte kirjeldus, kategooriad, fotod
3. Täpsusta sihtkataloogid lünkade analüüsist
4. Arvesta enamiku kataloogide puhul 2–4-nädalase ajakuluga
5. Auditeeri uuesti 6–8 nädala pärast, et kontrollida, kas kõik on avaldatud ja täpne

### Arvustuste genereerimine (Reputation Builder)

**Millal:** kasutaja peab süstemaatiliselt genereerima rohkem Google'i arvustusi.

**Kuidas Reputation Builder töötab:**
- Impordi klientide nimekiri (e-post või telefon)
- Saada automatiseeritud arvustuspalve e-posti või SMS-i teel
- Suunab rahulolevad kliendid Google'i arvustuslehele
- Jälgib, kes said palved, kes jätsid arvustused

**Mida agent peaks juhendama:**
1. **Ajastus**: saada arvustuspalved 1–3 päeva pärast teenuse lõpetamist
2. **Sõnum**: hoia see lühike, isiklik, lisa otselink Google'i arvustusele
3. **Maht**: ühtlane voog (5–10 nädalas) on parem kui 50 kaupa pursked
4. **Filtreerimine**: ära saada teadaolevalt rahulolematutele klientidele (väldi negatiivseid arvustusi)
5. **Vastavus**: ära motiveeri arvustusi, ära väravasta (filtreeri hinnangu põhjal)

**Arvustuste kiiruse sihid ettevõtte tüübi järgi:**
| Ettevõtte tüüp | Igakuine arvustussiht | Põhjendus |
|---------------|----------------------|-----------|
| Restoran | 15–30 | Suur tehingute maht |
| Meditsiinipraksis | 8–15 | Mõõdukas patsientide maht |
| Kodutehnika/-teenused | 5–10 | Väiksem tehingute sagedus |
| Õigus | 3–5 | Vähem kliente, raskem küsida |
| B2B-teenused | 2–4 | Väike maht, kõrge väärtus |

### Kohaliku positsiooni jälgimine

**Millal:** kasutaja kasutab Whitesparki positsioonijälgijat.

**Whitesparki positsioonijälgija** on punktipõhine (üks asukoht), mitte geovõrk.

**Mida agent peaks teadma:**
- See näitab positsiooni ÜHES punktis märksõna jaoks — mitte geograafilist katvust
- Kohalike ettevõtete jaoks on Local Falcon geovõrk kaugelt kasulikum
- Whitesparki positsioonijälgimine sobib orgaanilise märksõna jälgimiseks geovõrgu kõrval

## Whitesparki API-d

Kaks Whitesparki toodet pakuvad REST API-sid. Mõlemad on **beetas** — lõpp-punktid ja vastuse kujud võivad muutuda — ja kumbki pole MCP-server, nii et päringud tehakse otse või kohandatud integratsiooni kaudu, mitte agendi liidese kaudu. **Tsitaadi-API-t pole**; tsitaatide ehitamine ja auditid jäävad töölaua-/hallatavasse teenusesse.

Tsitaadi*andmete* jaoks on LocalSEOData (`citation_audit`) vaikimisi. Geovõrgu sügavuse jaoks, mis ületab seda, mida grids API pakub, annavad LocalSEOData (`geogrid_scan`) või Local Falcon punktitasandi andmeid.

### Local Ranking Grids (geovõrgu) API

Viide: https://lrg.whitespark.ca/api-docs

Ehitatud **aruandluse integratsiooni** jaoks — võrgukokkuvõtete tõmbamiseks ja võrguvisuaalide manustamiseks aruannetesse/töölaudadesse. See ei paku aluseks olevaid võrgu andmepunkte.

**Autentimine:** Bearer-token päises `Authorization`. Genereeri token rakenduses profiili rippmenüü all → API Access.

**Lõpp-punktid:**
- `GET /grids` — lehekülgedeks jaotatud sinu positsioonivõrkude nimekiri kokkuvõtlike mõõdikutega: nähtavuse skoor, keskmine positsioon ja arvustusskoor. Lehekülgedeks jaotus `page` (vaikimisi 1) ja `per_page` (vaikimisi 50, max 100) kaudu. Vastus on `data` pluss `meta` objekt (`current_page`, `last_page`, `per_page`, `total`).
- `GET /grid/{grid_id}/download-screenshot/{mode}` — tagastab võrgu uusima ekraanipildi; `mode` on `with-metrics` või `without-metrics`. `grid_id` on UUID võrgu URL-ist. Tagastab 404, kui ekraanipilti pole. Manustatav `<img>` kaudu. Luba API-ligipääsu lehel **Automatic screenshots**, et iga lõpetatud skaneerimine värskendaks seda URL-i.

**Pole API kaudu saadaval (ainult töölaud):** üksikud andmepunktid võrgu sees, konkurendi andmepunktid, võrkude loomine ning võrkude või käivitusgraafikute muutmine.

**Kasuta seda:** alati ajakohase geovõrgu pildi manustamiseks ning nähtavuse skoori / keskmise positsiooni / arvustusskoori tõmbamiseks igakuisesse aruandesse või portfelli kokkuvõttesse. **Ära kasuta seda, kui** vajad punktipõhiseid positsioone või konkurentide võrke — kasuta `geogrid_scan` (LocalSEOData) või Local Falcon'i.

### Local Rank Tracker API

Viide: https://whitespark-api.apidocumentation.com/rank-tracker-api-reference

Beeta (v1.0.0, OpenAPI 3.0.0), eraldi live- ja test-baas-URL-idega. **Autentimine:** API-võti edastatud päisena.

Korraldatud kolme ressursirühma ümber:
- **campaigns** — positsioonijälgimise kampaaniate loetlemine ja lugemine (kampaania on ettevõtte jälgitavate märksõnade ja asukohtade konteiner)
- **campaign** — üksiku kampaania töötlemine
- **rankings** — jälgitavate märksõnade positsioonitulemuste tõmbamine

Aluseks olev jälgija katab Google'i ja Bingi üle Local Packi, Mapsi ja orgaanilise, laua ja mobiili, kuni 100 positsiooni, geosihtimise ja kaalutud nähtavuse skooriga (Visibility Score). Kontrolli täpsed teed, parameetrid ja vastuse skeemid ülaltoodud API-viitest — beeta-dokumentatsioon on tõeallikas ja sealne „Download OpenAPI Document“ link annab täieliku skeemi. Beeta-küsimused saada troy@whitespark.ca.

**Kasuta seda:** orgaanilise/Local Packi märksõnapositsiooni ja Visibility Score'i tõmbamise automatiseerimiseks korduvatesse aruannetesse geovõrguandmete kõrval. **Ära kasuta seda, kui** geograafiline katvus loeb rohkem kui ühe punkti positsioonid — selle jaoks on grids API ja `geogrid_scan`.

## Mida järgmiseks teha

| Mida leidsid | Järgmine tegevus | Oskus |
|----------------|-------------|-------|
| Tsitaadilüngad tuvastatud | Ehita puuduvad tsitaadid, alusta 1. tasemest | `local-citations` |
| Tsitaadid ehitatud, ootab levikut | Tegele muu optimeerimisega oodates (4–8 nädalat) | `gbp-optimization`, `review-management` |
| Arvustuste genereerimise kampaania käib | Jälgi kiirust ja kohanda sõnumeid, kui vastamismäär on madal | `review-management` |
| Tsitaadiandmed peavad aruandesse minema | Lisa auditisse või igakuisesse aruandesse | `client-deliverables`, `local-reporting` |
| Vaja MCP-ligipääsetavaid tsitaadiandmeid | Kasuta hoopis BrightLocal'i | `brightlocal-tool` |
| Vaja võrguvisuaale või kokkuvõtlikke mõõdikuid aruandes | Tõmba Local Ranking Grids API kaudu | `local-reporting`, `client-deliverables` |
| Vaja märksõnapositsioone või Visibility Score'i aruandes | Tõmba Local Rank Tracker API kaudu | `local-reporting` |

**Vaikimisi järgmine samm:** Whitesparki tugevus on hallatavad tsitaaditeenused. Kui vajad automatiseeritud, agendile ligipääsetavaid tsitaadiandmeid, kasuta BrightLocal'i. Kui vajad kõrgeima kvaliteediga tsitaatide ehitamist, kasuta Whitesparki hallatavat teenust.