# Brand Monitor

> Monitoreo de marca y seguimiento de menciones mediante la API de Brand.dev: sentimiento, oportunidades de PR, detección de logos y presencia de marca online.

Fuente: https://skillsagentes.com/skills/openclaudia/openclaudia-skills/brand-monitor
Markdown: https://skillsagentes.com/skills/openclaudia/openclaudia-skills/brand-monitor.md

Repositorio: https://github.com/OpenClaudia/openclaudia-skills
Autor: OpenClaudia
Licencia: MIT
Actualizado: hace 7 meses
Coste de contexto: 90 tok instalada, 2.1k tok al activarse, 2.1k tok con todos los archivos del bundle
Bundle: 1 archivo, 8 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add OpenClaudia/openclaudia-skills --skill brand-monitor --agent claude-code
# Cursor
npx -y skills add OpenClaudia/openclaudia-skills --skill brand-monitor --agent cursor
# Codex
npx -y skills add OpenClaudia/openclaudia-skills --skill brand-monitor --agent codex
# Gemini CLI
npx -y skills add OpenClaudia/openclaudia-skills --skill brand-monitor --agent gemini
# Windsurf
npx -y skills add OpenClaudia/openclaudia-skills --skill brand-monitor --agent windsurf
# Cline
npx -y skills add OpenClaudia/openclaudia-skills --skill brand-monitor --agent cline
```

## Qué hace

- Busca menciones de una marca en la web con la API de Brand.dev
- Obtiene información estructurada de una marca (logo, colores, sector, sede)
- Detecta uso de logos en imágenes por la web
- Crea monitores continuos de menciones con palabras clave y notificaciones
- Analiza sentimiento de menciones y compara volumen/sentimiento frente a competidores

## Cuándo usarla

- Cuando se pide monitorear menciones de marca, sentimiento o presencia online
- Cuando se busca detectar uso de logo o localizar oportunidades de PR
- Cuando se solicita un informe de auditoría de marca completo

## Qué la activa

- "Monitorea las menciones de mi marca en las últimas 4 semanas"
- "Busca dónde se está usando nuestro logo sin autorización"
- "Compara el sentimiento de mi marca contra la competencia"
- "Genera un informe de auditoría de marca completo"

## Antes de instalar

- Requiere la variable BRANDDEV_API_KEY configurada en .env, .env.local o ~/.claude/.env.global, obtenida en https://brand.dev/.
- Necesita en el PATH: curl, python3
- Variables de entorno: BRANDDEV_API_KEY
- makes network requests
- needs API credentials

## Archivos

- SKILL.md — 8 KB

## SKILL.md

Reproducido tal cual desde OpenClaudia/openclaudia-skills bajo MIT. Esta sección es el documento original y está en inglés.

# Brand Monitor

Track brand mentions, analyze sentiment, and discover PR opportunities using the Brand.dev API.

## Prerequisites

Requires `BRANDDEV_API_KEY` set in `.env`, `.env.local`, or `~/.claude/.env.global`.

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

If the key is not set, instruct the user:
> You need a Brand.dev API key. Get one at https://brand.dev/
> Then add `BRANDDEV_API_KEY=your_key` to your `.env` file.

## API Base

All requests go to `https://api.brand.dev/v1/` with the header `Authorization: Bearer {BRANDDEV_API_KEY}`.

---

## 1. Brand Search

Search for mentions of a brand name across the web.

### Endpoint

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

### Parameters

| Param | Type | Description |
|-------|------|-------------|
| `query` | string | Brand name or phrase to search |
| `limit` | int | Number of results (default 20, max 100) |
| `offset` | int | Pagination offset |
| `sort` | string | `relevance` or `date` |
| `from_date` | string | Start date (YYYY-MM-DD) |
| `to_date` | string | End date (YYYY-MM-DD) |

### Example curl

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

### Response Parsing

```bash
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. Brand Info Lookup

Get structured brand information for any company or product.

### Endpoint

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

### Parameters

| Param | Type | Description |
|-------|------|-------------|
| `domain` | string | Company domain (e.g., `stripe.com`) |
| `name` | string | Brand name (alternative to domain) |

### Example curl

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

### Response Fields

- `name`: Official brand name
- `domain`: Primary domain
- `description`: Brand description
- `industry`: Industry classification
- `founded`: Year founded
- `headquarters`: Location
- `social_profiles`: Links to social media
- `logos`: Brand logo URLs
- `colors`: Brand color palette
- `employees_range`: Company size estimate

---

## 3. Logo Detection

Detect brand logos in images across the web.

### Endpoint

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

### Parameters

| Param | Type | Description |
|-------|------|-------------|
| `brand` | string | Brand name to search for |
| `domain` | string | Filter to specific domain |
| `limit` | int | Number of results |

### Example curl

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

Use logo detection to find:
- Unauthorized logo usage
- Partner and sponsor visibility
- Event coverage and media placements
- Counterfeit product listings

---

## 4. Mention Tracking

Set up ongoing tracking for brand mentions.

### Create a Monitor

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

### Body

```json
{
  "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"
}
```

### Example curl

```bash
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"]
  }'
```

### List Monitors

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

### Get Monitor Results

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

---

## 5. Sentiment Analysis

Analyze sentiment of brand mentions.

### Endpoint

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

### Parameters

| Param | Type | Description |
|-------|------|-------------|
| `query` | string | Brand name |
| `from_date` | string | Start date |
| `to_date` | string | End date |
| `granularity` | string | `day`, `week`, or `month` |

### Example curl

```bash
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"
```

### Sentiment Scores

- **Positive** (> 0.3): Praise, recommendations, positive reviews
- **Neutral** (-0.3 to 0.3): Factual mentions, news coverage
- **Negative** (< -0.3): Complaints, criticism, negative reviews

---

## 6. Competitor Mention Comparison

Compare brand mention volume and sentiment against competitors.

### Workflow

1. Search mentions for your brand and each competitor
2. Compare mention counts over the same time period
3. Compare sentiment distributions
4. Identify sources where competitors get mentioned but you do not

```bash
# 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
```

---

## Workflow: Full Brand Audit

When asked for a comprehensive brand monitoring report:

### Step 1: Brand Info

Pull structured brand data for context.

### Step 2: Mention Volume

Search for brand mentions over the last 30/90 days. Count total mentions and break down by source type.

### Step 3: Sentiment Analysis

Get sentiment trends. Flag any negative spikes and investigate root causes.

### Step 4: PR Opportunities

From mention data, identify:
- **High-authority sites** that mention competitors but not you
- **Journalists** who cover your industry
- **Trending topics** where your brand could contribute
- **Unanswered questions** about your brand on forums

### Step 5: Logo/Visual Presence

Search for logo appearances. Flag unauthorized usage.

### Step 6: Report

Present findings as:

```
## 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]
```

---

## Error Handling

| Status | Meaning |
|--------|---------|
| 401 | Invalid or expired API key |
| 403 | Insufficient permissions for this endpoint |
| 404 | Resource not found (check monitor ID) |
| 429 | Rate limit exceeded - wait and retry |
| 500 | Server error - retry after a few seconds |

## Tips

- Use exact brand name + common misspellings as keywords
- Exclude your own domain to avoid self-mentions
- Set up monitors for competitor brands too
- Check mentions weekly at minimum; daily during launches or crises
- Export negative mentions to a spreadsheet for customer support follow-up

## Dónde encaja

- Categoría: [Marketing](https://skillsagentes.com/categorias/marketing.md) — Campañas, copy, lanzamientos y ciclos de crecimiento.
- Creador: [OpenClaudia](https://skillsagentes.com/creators/openclaudia.md) — 76 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Competitor Traffic Report](https://skillsagentes.com/skills/openclaudia/openclaudia-skills/competitor-traffic-report.md): Genera un informe HTML autocontenible de tráfico competitivo: visitas mensuales (SimilarWeb), tráfico orgánico y Domain Rating (Ahrefs), con gráficos ranked, tendencias y tabla de datos.
- [Brand Dev](https://skillsagentes.com/skills/openclaudia/openclaudia-skills/brand-dev.md): Obtiene datos de marca (nombre, descripción, logos, industria) desde la API de brand.dev y guarda los logos localmente.
- [Gsc Portfolio Audit](https://skillsagentes.com/skills/openclaudia/openclaudia-skills/gsc-portfolio-audit.md): Audita TODAS las propiedades de Google Search Console a la vez: ranking por clics e impresiones con deltas, y diff de keywords por sitio (nuevas, suben, bajan, perdidas, o bien rankeadas sin clics).
- [Wechat Moments](https://skillsagentes.com/skills/openclaudia/openclaudia-skills/wechat-moments.md): Clasifica y resume el feed de WeChat Moments (朋友圈) del usuario para que los eventos reales y la información genuina destaquen sobre la promoción, ponderando según cuánto le escribe el usuario a cada autor.
- [Podcast Edit](https://skillsagentes.com/skills/openclaudia/openclaudia-skills/podcast-edit.md): Edita audio o video de podcast: recorta charla previa/posterior, quita muletillas, corta silencios, mejora el audio y aplica el mismo corte a una versión en video.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)