Brändiseire

Jälgi brändi mainimisi, analüüsi meelestatust ja avasta PR-võimalusi Brand.dev API abil.

Eeldused

Nõuab, et BRANDDEV_API_KEY oleks seatud failis .env, .env.local või ~/.claude/.env.global.

echo "BRANDDEV_API_KEY is ${BRANDDEV_API_KEY:+set}"

Kui võtit pole seatud, juhenda kasutajat:

Sul on vaja Brand.dev API võtit. Hangi see aadressilt https://brand.dev/ Seejärel lisa oma .env faili BRANDDEV_API_KEY=your_key.

API baas

Kõik päringud lähevad aadressile https://api.brand.dev/v1/ päisega Authorization: Bearer {BRANDDEV_API_KEY}.

1. Brändi otsing

Otsi brändinime mainimisi üle veebi.

Lõpp-punkt

GET https://api.brand.dev/v1/brand/search

Parameetrid

Parameeter	Tüüp	Kirjeldus
`query`	string	Otsitav brändinimi või fraas
`limit`	int	Tulemuste arv (vaikimisi 20, maksimaalselt 100)
`offset`	int	Lehekülgede nihe
`sort`	string	`relevance` või `date`
`from_date`	string	Alguskuupäev (YYYY-MM-DD)
`to_date`	string	Lõppkuupäev (YYYY-MM-DD)

Näidis-curl

curl -s -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
  "https://api.brand.dev/v1/brand/search?query=YourBrand&limit=20&sort=date"

Vastuse parsimine

curl -s -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
  "https://api.brand.dev/v1/brand/search?query=YourBrand&limit=20" \
  | python3 -c "
import json, sys
data = json.load(sys.stdin)
for m in data.get('results', []):
    print(f\"Source: {m.get('source','')}  |  Title: {m.get('title','')}  |  Sentiment: {m.get('sentiment','n/a')}  |  Date: {m.get('published_at','')}\")
    print(f\"  URL: {m.get('url','')}\")
    print()
"

2. Brändiinfo otsing

Hangi struktureeritud brändiinfo mis tahes ettevõtte või toote kohta.

Lõpp-punkt

GET https://api.brand.dev/v1/brand/info

Parameetrid

Parameeter	Tüüp	Kirjeldus
`domain`	string	Ettevõtte domeen (nt `stripe.com`)
`name`	string	Brändinimi (domeeni alternatiiv)

Näidis-curl

curl -s -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
  "https://api.brand.dev/v1/brand/info?domain=stripe.com"

Vastuse väljad

name: Ametlik brändinimi
domain: Peamine domeen
description: Brändi kirjeldus
industry: Tegevusala klassifikatsioon
founded: Asutamisaasta
headquarters: Asukoht
social_profiles: Lingid sotsiaalmeediasse
logos: Brändi logode URL-id
colors: Brändi värvipalett
employees_range: Ettevõtte suuruse hinnang

3. Logo tuvastamine

Tuvasta brändilogosid piltidelt üle veebi.

Lõpp-punkt

GET https://api.brand.dev/v1/logo/search

Parameetrid

Parameeter	Tüüp	Kirjeldus
`brand`	string	Otsitav brändinimi
`domain`	string	Filtreeri kindla domeeni järgi
`limit`	int	Tulemuste arv

Näidis-curl

curl -s -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
  "https://api.brand.dev/v1/logo/search?brand=YourBrand&limit=20"

Kasuta logo tuvastamist, et leida: - Loata logo kasutus - Partnerite ja sponsorite nähtavus - Ürituste kajastus ja meediapaigutused - Võltstoodete kuulutused

4. Mainimiste jälgimine

Sea üles pidev brändimainimiste jälgimine.

Monitori loomine

POST https://api.brand.dev/v1/monitors

Keha

{
  "name": "My Brand Monitor",
  "keywords": ["YourBrand", "Your Brand", "yourbrand.com"],
  "exclude_keywords": ["unrelated term"],
  "sources": ["news", "blogs", "social", "forums", "reviews"],
  "languages": ["en"],
  "notify_email": "alerts@yourdomain.com"
}

Näidis-curl

curl -s -X POST -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
  -H "Content-Type: application/json" \
  "https://api.brand.dev/v1/monitors" \
  -d '{
    "name": "Brand Alert",
    "keywords": ["YourBrand"],
    "sources": ["news", "blogs", "social"],
    "languages": ["en"]
  }'

Monitoride loetelu

curl -s -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
  "https://api.brand.dev/v1/monitors"

Monitori tulemuste hankimine

curl -s -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
  "https://api.brand.dev/v1/monitors/{monitor_id}/mentions?limit=50&sort=date"

5. Meelestatuse analüüs

Analüüsi brändimainimiste meelestatust.

Lõpp-punkt

GET https://api.brand.dev/v1/brand/sentiment

Parameetrid

Parameeter	Tüüp	Kirjeldus
`query`	string	Brändinimi
`from_date`	string	Alguskuupäev
`to_date`	string	Lõppkuupäev
`granularity`	string	`day`, `week` või `month`

Näidis-curl

curl -s -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
  "https://api.brand.dev/v1/brand/sentiment?query=YourBrand&from_date=2024-01-01&to_date=2024-03-31&granularity=week"

Meelestatuse skoorid

Positiivne (> 0,3): Kiitus, soovitused, positiivsed arvustused
Neutraalne (-0,3 kuni 0,3): Faktilised mainimised, uudiskajastus
Negatiivne (< -0,3): Kaebused, kriitika, negatiivsed arvustused

6. Konkurentide mainimiste võrdlus

Võrdle brändimainimiste mahtu ja meelestatust konkurentidega.

Töövoog

Otsi mainimisi oma brändi ja iga konkurendi kohta
Võrdle mainimiste arvu sama ajavahemiku lõikes
Võrdle meelestatuse jaotusi
Tuvasta allikad, kus konkurente mainitakse, kuid sind mitte

# For each brand, get mention counts
for brand in "YourBrand" "Competitor1" "Competitor2"; do
  count=$(curl -s -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
    "https://api.brand.dev/v1/brand/search?query=${brand}&limit=1" \
    | python3 -c "import json,sys; print(json.load(sys.stdin).get('total',0))")
  echo "${brand}: ${count} mentions"
done

Töövoog: täielik brändiaudit

Kui palutakse koostada põhjalik brändiseire raport:

1. samm: brändiinfo

Tõmba konteksti jaoks struktureeritud brändiandmed.

2. samm: mainimiste maht

Otsi brändimainimisi viimase 30/90 päeva jooksul. Loe kokku mainimiste koguarv ja jaota allikatüübi järgi.

3. samm: meelestatuse analüüs

Hangi meelestatuse trendid. Märgista kõik negatiivsed hüpped ja uuri algpõhjuseid.

4. samm: PR-võimalused

Mainimisandmetest tuvasta: - Kõrge autoriteediga saidid, mis mainivad konkurente, aga mitte sind - Ajakirjanikud, kes kajastavad sinu tegevusala - Trendikad teemad, kus sinu bränd saaks kaasa rääkida - Vastamata küsimused sinu brändi kohta foorumites

5. samm: logo/visuaalne kohalolu

Otsi logode esinemisi. Märgista loata kasutus.

6. samm: raport

Esita leiud kujul:

## Brand Monitoring Report: {Brand}

### Overview
- Total mentions (last 30 days): X
- Sentiment breakdown: X% positive, X% neutral, X% negative
- Top sources: ...

### Sentiment Trend
[Weekly trend data]

### Top Positive Mentions
1. [Source] - [Title] - [URL]
2. ...

### Negative Mentions Requiring Attention
1. [Source] - [Title] - [URL] - [Issue summary]
2. ...

### PR Opportunities
1. [Publication] covers [topic] - pitch angle: ...
2. [Journalist] recently wrote about [topic] - pitch angle: ...

### Competitor Comparison
| Metric | Your Brand | Competitor A | Competitor B |
|--------|-----------|-------------|-------------|
| Mentions | ... | ... | ... |
| Positive % | ... | ... | ... |
| Top Source | ... | ... | ... |

### Action Items
- [ ] Respond to [negative mention]
- [ ] Pitch [publication] about [topic]
- [ ] Update brand listing on [platform]

Vigade käsitlemine

Olek	Tähendus
401	Vigane või aegunud API võti
403	Ebapiisavad õigused selle lõpp-punkti jaoks
404	Ressurssi ei leitud (kontrolli monitori ID-d)
429	Päringulimiit ületatud – oota ja proovi uuesti
500	Serveri viga – proovi mõne sekundi pärast uuesti

Nipid

Kasuta märksõnadena täpset brändinime + levinud kirjavigu
Välista oma domeen, et vältida enesemainimisi
Sea monitorid üles ka konkurentide brändidele
Kontrolli mainimisi vähemalt kord nädalas; igapäevaselt toodete turuletuleku või kriiside ajal
Ekspordi negatiivsed mainimised arvutustabelisse klienditoe järeltegevuse jaoks

Brändi jälgimine

Brändiseire

Eeldused

API baas

1. Brändi otsing

Lõpp-punkt

Parameetrid

Näidis-curl

Vastuse parsimine

2. Brändiinfo otsing

Lõpp-punkt

Parameetrid

Näidis-curl

Vastuse väljad

3. Logo tuvastamine

Lõpp-punkt

Parameetrid

Näidis-curl

4. Mainimiste jälgimine

Monitori loomine

Keha

Näidis-curl

Monitoride loetelu

Monitori tulemuste hankimine

5. Meelestatuse analüüs

Lõpp-punkt

Parameetrid

Näidis-curl

Meelestatuse skoorid

6. Konkurentide mainimiste võrdlus

Töövoog

Töövoog: täielik brändiaudit

1. samm: brändiinfo

2. samm: mainimiste maht

3. samm: meelestatuse analüüs

4. samm: PR-võimalused

5. samm: logo/visuaalne kohalolu

6. samm: raport

Vigade käsitlemine

Nipid