跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
浏览器与自动化

brand-monitor

Brand monitoring and mention tracking via the Brand.dev API. Use when asked to monitor brand mentions, track sentiment, find PR opportunities, detect logo usage, or analyze brand presence online. Trigger phrases: "brand monitoring", "mention tracking", "brand sentiment", "PR opportunities", "logo detection", "brand.dev", "brand mentions", "media monitoring".

OpenClaudia · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add OpenClaudia/openclaudia-skills --skill brand-monitor

技能说明


name: brand-monitor description: > Brand monitoring and mention tracking via the Brand.dev API. Use when asked to monitor brand mentions, track sentiment, find PR opportunities, detect logo usage, or analyze brand presence online. Trigger phrases: "brand monitoring", "mention tracking", "brand sentiment", "PR opportunities", "logo detection", "brand.dev", "brand mentions", "media monitoring".

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.

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

ParamTypeDescription
querystringBrand name or phrase to search
limitintNumber of results (default 20, max 100)
offsetintPagination offset
sortstringrelevance or date
from_datestringStart date (YYYY-MM-DD)
to_datestringEnd date (YYYY-MM-DD)

Example curl

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

Response Parsing

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

ParamTypeDescription
domainstringCompany domain (e.g., stripe.com)
namestringBrand name (alternative to domain)

Example curl

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

ParamTypeDescription
brandstringBrand name to search for
domainstringFilter to specific domain
limitintNumber of results

Example curl

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

{
  "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

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

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

Get Monitor Results

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

ParamTypeDescription
querystringBrand name
from_datestringStart date
to_datestringEnd date
granularitystringday, week, or month

Example 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"

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
# For each brand, get mention counts
for brand in "YourBrand" "Competitor1" "Competitor2"; do
  count=$(curl -s -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
    "https://
阅读完整来源 ↗