Back to Details

brand-monitor

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Brand Monitor

品牌监控工具

Track brand mentions, analyze sentiment, and discover PR opportunities using the Brand.dev API.
通过Brand.dev API追踪品牌提及、分析舆情倾向并发现PR机会。

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.
需要在.env、.env.local或~/.claude/.env.global中配置
BRANDDEV_API_KEY
。
bash
echo "BRANDDEV_API_KEY is ${BRANDDEV_API_KEY:+set}"
如果未配置密钥，请告知用户：
你需要一个Brand.dev API密钥。请访问https://brand.dev/获取。 然后将
BRANDDEV_API_KEY=your_key
添加到你的.env文件中。

API Base

API基础地址

All requests go to 
https://api.brand.dev/v1/
with the header 
Authorization: Bearer {BRANDDEV_API_KEY}
.
所有请求均发送至
https://api.brand.dev/v1/
，请求头需包含
Authorization: Bearer {BRANDDEV_API_KEY}
。

1. Brand Search

1. 品牌搜索

Search for mentions of a brand name across the web.
在全网搜索品牌名称的提及内容。

Endpoint

接口地址

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

Parameters

参数

ParamTypeDescription
query
stringBrand name or phrase to search
limit
intNumber of results (default 20, max 100)
offset
intPagination offset
sort
string
relevance
or 
date
from_date
stringStart date (YYYY-MM-DD)
to_date
stringEnd date (YYYY-MM-DD)
参数类型描述
query
字符串要搜索的品牌名称或短语
limit
整数结果数量（默认20，最大100）
offset
整数分页偏移量
sort
字符串
relevance
（相关性）或
date
（日期）
from_date
字符串开始日期（格式：YYYY-MM-DD）
to_date
字符串结束日期（格式：YYYY-MM-DD）

Example curl

示例curl命令

bash
curl -s -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
  "https://api.brand.dev/v1/brand/search?query=YourBrand&limit=20&sort=date"
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()
"
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\"来源: {m.get('source','')}  |  标题: {m.get('title','')}  |  舆情倾向: {m.get('sentiment','n/a')}  |  日期: {m.get('published_at','')}\")
    print(f\"  链接: {m.get('url','')}\")
    print()
"

2. Brand Info Lookup

2. 品牌信息查询

Get structured brand information for any company or product.
获取任意公司或产品的结构化品牌信息。

Endpoint

接口地址

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

Parameters

参数

ParamTypeDescription
domain
stringCompany domain (e.g., 
stripe.com
)
name
stringBrand name (alternative to domain)
参数类型描述
domain
字符串公司域名（例如：
stripe.com
）
name
字符串品牌名称（域名的替代参数）

Example curl

示例curl命令

bash
curl -s -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
  "https://api.brand.dev/v1/brand/info?domain=stripe.com"
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
  • name
    : 官方品牌名称
  • domain
    : 主域名
  • description
    : 品牌描述
  • industry
    : 行业分类
  • founded
    : 成立年份
  • headquarters
    : 总部所在地
  • social_profiles
    : 社交媒体链接
  • logos
    : 品牌Logo链接
  • colors
    : 品牌配色方案
  • employees_range
    : 公司规模预估

3. Logo Detection

3. Logo检测

Detect brand logos in images across the web.
检测全网图片中的品牌Logo。

Endpoint

接口地址

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

Parameters

参数

ParamTypeDescription
brand
stringBrand name to search for
domain
stringFilter to specific domain
limit
intNumber of results
参数类型描述
brand
字符串要搜索的品牌名称
domain
字符串筛选特定域名下的结果
limit
整数结果数量

Example curl

示例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
bash
curl -s -H "Authorization: Bearer ${BRANDDEV_API_KEY}" \
  "https://api.brand.dev/v1/logo/search?brand=YourBrand&limit=20"
使用Logo检测可发现：
  • 未经授权的Logo使用
  • 合作伙伴与赞助商的曝光情况
  • 活动报道与媒体露出
  • 假冒产品列表

4. Mention Tracking

4. 提及追踪

Set up ongoing tracking for brand mentions.
设置品牌提及的持续追踪。

Create a Monitor

创建监控任务

POST https://api.brand.dev/v1/monitors
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"
}
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

示例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"]
  }'
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"
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"
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

5. 舆情分析

Analyze sentiment of brand mentions.
分析品牌提及的舆情倾向。

Endpoint

接口地址

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

Parameters

参数

ParamTypeDescription
query
stringBrand name
from_date
stringStart date
to_date
stringEnd date
granularity
string
day
, 
week
, or 
month
参数类型描述
query
字符串品牌名称
from_date
字符串开始日期
to_date
字符串结束日期
granularity
字符串
day
（按天）、
week
（按周）或
month
（按月）

Example curl

示例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"
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
  • 正面 (> 0.3)：赞扬、推荐、正面评价
  • 中性 (-0.3 至 0.3)：事实性提及、新闻报道
  • 负面 (< -0.3)：投诉、批评、负面评价

6. Competitor Mention Comparison

6. 竞品提及对比

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
undefined
  1. 搜索自身品牌及各竞品的提及内容
  2. 对比同一时间段内的提及数量
  3. 对比舆情分布情况
  4. 发现竞品被提及但自身未被提及的渠道
bash
undefined

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

---
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} 条提及" done

---

Workflow: Full Brand Audit

工作流：完整品牌审计

When asked for a comprehensive brand monitoring report:
当需要生成全面的品牌监控报告时：

Step 1: Brand Info

步骤1：品牌信息

Pull structured brand data for context.
拉取结构化品牌数据作为背景信息。

Step 2: Mention Volume

步骤2：提及量统计

Search for brand mentions over the last 30/90 days. Count total mentions and break down by source type.
搜索过去30/90天的品牌提及内容，统计总提及量并按来源类型细分。

Step 3: Sentiment Analysis

步骤3：舆情分析

Get sentiment trends. Flag any negative spikes and investigate root causes.
获取舆情趋势，标记负面峰值并调查根本原因。

Step 4: PR Opportunities

步骤4：PR机会挖掘

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

步骤5：Logo/视觉曝光

Search for logo appearances. Flag unauthorized usage.
搜索Logo出现情况，标记未经授权的使用。

Step 6: Report

步骤6：生成报告

Present findings as:
undefined
按以下格式呈现结果：
undefined

Brand Monitoring Report: {Brand}

品牌监控报告：{品牌名称}

Overview

概述

  • Total mentions (last 30 days): X
  • Sentiment breakdown: X% positive, X% neutral, X% negative
  • Top sources: ...
  • 总提及量（过去30天）：X
  • 舆情分布：X% 正面，X% 中性，X% 负面
  • 主要来源：...

Sentiment Trend

舆情趋势

[Weekly trend data]
[每周趋势数据]

Top Positive Mentions

主要正面提及

  1. [Source] - [Title] - [URL]
  2. ...
  1. [来源] - [标题] - [链接]
  2. ...

Negative Mentions Requiring Attention

需要关注的负面提及

  1. [Source] - [Title] - [URL] - [Issue summary]
  2. ...
  1. [来源] - [标题] - [链接] - [问题摘要]
  2. ...

PR Opportunities

PR机会

  1. [Publication] covers [topic] - pitch angle: ...
  2. [Journalist] recently wrote about [topic] - pitch angle: ...
  1. [出版物] 报道了[话题] - 推广角度：...
  2. [记者] 近期撰写了[话题] - 推广角度：...

Competitor Comparison

竞品对比

MetricYour BrandCompetitor ACompetitor B
Mentions.........
Positive %.........
Top Source.........
指标自身品牌竞品A竞品B
提及量.........
正面占比.........
主要来源.........

Action Items

行动项

  • Respond to [negative mention]
  • Pitch [publication] about [topic]
  • Update brand listing on [platform]

---
  • 回复[负面提及]
  • 向[出版物]推广[话题]
  • 更新[平台]上的品牌信息

---

Error Handling

错误处理

StatusMeaning
401Invalid or expired API key
403Insufficient permissions for this endpoint
404Resource not found (check monitor ID)
429Rate limit exceeded - wait and retry
500Server error - retry after a few seconds
状态码含义
401API密钥无效或已过期
403无此接口的访问权限
404资源不存在（检查监控任务ID）
429请求频率超限 - 等待后重试
500服务器错误 - 几秒后重试

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
  • 使用精确品牌名称+常见拼写错误作为关键词
  • 排除自身域名以避免自提及
  • 同时为竞品品牌设置监控任务
  • 至少每周检查提及内容；在产品发布或危机期间需每日检查
  • 将负面提及导出至电子表格，以便客户支持跟进