brand-monitor

ブランドモニター

Brand.dev API を使用して、ブランドへの言及を追跡し、センチメントを分析し、PR の機会を見つけます。

前提条件

BRANDDEV_API_KEY が .env、.env.local、または ~/.claude/.env.global に設定されている必要があります。

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

キーが設定されていない場合は、ユーザーに次のように伝えてください。

Brand.dev API キーが必要です。https://brand.dev/ で取得してください。 次に、.env ファイルに BRANDDEV_API_KEY=your_key を追加してください。

API のベース URL

すべてのリクエストは、ヘッダー Authorization: Bearer {BRANDDEV_API_KEY} を指定して https://api.brand.dev/v1/ に送信します。

---

1. ブランド検索

ウェブ全体からブランド名への言及を検索します。

エンドポイント

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

パラメーター

Param	Type	Description
query	string	検索するブランド名またはフレーズ
limit	int	結果数（デフォルトは20、最大100）
offset	int	ページネーションのオフセット
sort	string	relevance または date
from_date	string	開始日（YYYY-MM-DD）
to_date	string	終了日（YYYY-MM-DD）

curl の例

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

レスポンスの解析

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. ブランド情報の検索

企業や製品の構造化されたブランド情報を取得します。

エンドポイント

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

パラメーター

Param	Type	Description
domain	string	企業のドメイン（例：stripe.com）
name	string	ブランド名（ドメインの代わりに指定）

curl の例

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

レスポンスフィールド

• name：正式なブランド名
• domain：主要ドメイン
• description：ブランドの説明
• industry：業種分類
• founded：設立年
• headquarters：所在地
• social_profiles：ソーシャルメディアへのリンク
• logos：ブランドロゴの URL
• colors：ブランドのカラーパレット
• employees_range：企業規模の推定

---

3. ロゴ検出

ウェブ上の画像からブランドロゴを検出します。

エンドポイント

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

パラメーター

Param	Type	Description
brand	string	検索するブランド名
domain	string	特定のドメインに絞り込む
limit	int	結果数

curl の例

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

ロゴ検出を使用して、次の項目を見つけます。

• 無断で使用されているロゴ
• パートナーやスポンサーの露出
• イベントの報道やメディアへの掲載
• 偽造品の商品リスト

---

4. 言及の追跡

ブランドへの言及を継続的に追跡するよう設定します。

モニターの作成

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

リクエストボディ

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

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

モニターの一覧表示

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

モニター結果の取得

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

---

5. センチメント分析

ブランドへの言及のセンチメントを分析します。

エンドポイント

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

パラメーター

Param	Type	Description
query	string	ブランド名
from_date	string	開始日
to_date	string	終了日
granularity	string	day、week、または month

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"

センチメントスコア

• 肯定的（> 0.3）：称賛、おすすめ、肯定的なレビュー
• 中立（-0.3～0.3）：事実に基づく言及、ニュース報道
• 否定的（< -0.3）：苦情、批判、否定的なレビュー

---

6. 競合他社との言及比較

ブランドへの言及量とセンチメントを競合他社と比較します。

ワークフロー

1. 自社ブランドと各競合他社への言及を検索します
2. 同じ期間における言及数を比較します
3. センチメントの分布を比較します
4. 競合他社には言及があるものの、自社にはない情報源を特定します

# 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

---

ワークフロー：ブランドの総合監査

包括的なブランドモニタリングレポートを求められた場合：

ステップ 1：ブランド情報

背景情報として、構造化されたブランドデータを取得します。

ステップ 2：言及量

過去30日または90日間のブランドへの言及を検索します。言及の総数を数え、情報源の種類ごとに分類します。

ステップ 3：センチメント分析

センチメントの傾向を取得します。否定的な急増があれば警告し、根本原因を調査します。

ステップ 4：PR の機会

メンションデータから、次の項目を特定します。

• 競合他社には言及しているが、自社には言及していない権威性の高いサイト
• 業界を担当するジャーナリスト
• 自社ブランドが貢献できるトレンドトピック
• フォーラムで自社ブランドについて未回答の質問

ステップ 5：ロゴ／ビジュアルの掲載状況

ロゴが掲載されている場所を検索します。無断使用があれば報告します。

ステップ 6：レポート

調査結果を次の形式で提示します。

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

---

エラー処理

ステータス	意味
401	API キーが無効または期限切れです
403	このエンドポイントを利用する権限が不足しています
404	リソースが見つかりません（モニター ID を確認してください）
429	レート制限を超えました。時間をおいて再試行してください
500	サーバーエラーです。数秒後に再試行してください

ヒント

• 正確なブランド名と、よくあるスペルミスをキーワードとして使用します
• 自社への言及を除外するため、自社ドメインを除外します
• 競合他社のブランドについてもモニターを設定します
• 最低でも毎週、ローンチ時や危機発生時には毎日メンションを確認します
• ネガティブなメンションをスプレッドシートにエクスポートし、カスタマーサポートのフォローアップに活用します