Agent skill

Brand Monitor

by OpenClaudia in OpenClaudia/openclaudia-skills

Brand monitoring and mention tracking via the Brand.dev API.

MITAuto-check: notesMedia & Creative

Install Brand Monitor

skills CLI
$ npx skills add OpenClaudia/openclaudia-skills --skill brand-monitor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install OpenClaudia/openclaudia-skills brand-monitor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/OpenClaudia/openclaudia-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/brand-monitor .claude/skills/brand-monitor && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
brand-monitor
GitHub stars
713
Token cost
~2.1k tokens
SKILL.md length
561 words
Files
1
Skills in repo
74
Repo updated
First seen
Licence
MIT

At a glance

Brand monitoring and mention tracking via the Brand.dev API.

  • Works in 6 steps: Brand Search → Brand Info Lookup → Logo Detection → …
  • Asked to monitor brand mentions
  • SKILL.md covers Prerequisites, API Base, 1. Brand Search and 2. Brand Info Lookup, plus 4 more sections
  • Calls curl and python3; reaches api.brand.dev; needs BRANDDEV_API_KEY

What it does

Brand Monitor is an agent skill from OpenClaudia/openclaudia-skills. 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".

Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Logo and visual identity. The repository describes itself as: 77 open-source marketing skills for Claude Code, Codex, and other AI coding agents. SEO, content, email, ads, analytics, and growth. The licence is MIT.

When your agent uses it

  • Asked to monitor brand mentions
  • Track sentiment
  • Find PR opportunities
  • Detect logo usage

Example prompts

  • “brand monitoring”
  • “mention tracking”
  • “brand sentiment”
  • “/brand-monitor”

Requirements

  • Python 3
  • A credential in BRANDDEV_API_KEY

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Brand Search
  2. Brand Info Lookup
  3. Logo Detection
  4. Mention Tracking
  5. Sentiment Analysis
  6. Competitor Mention Comparison

What it can do on your machine

Read from SKILL.md and the folder at commit 28bf209. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.brand.dev

    Also links to:

    • brand.dev

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • BRANDDEV_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Brand Monitor loads about 2.1k tokens when it runs. Until then it costs about 94 tokens; SKILL.md has 561 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~94
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:17
    Requires `BRANDDEV_API_KEY` set in `.env`, `.env.local`, or `~/.claude/.env.global`.
  • NoteMentions a .env fileSKILL.md:25
    add `BRANDDEV_API_KEY=your_key` to your `.env` file.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from OpenClaudia/openclaudia-skills at commit 28bf209, republished under its MIT licence (© OpenClaudia). 561 words, ~2,118 tokens.

Download SKILL.mdSave it as .claude/skills/brand-monitor/SKILL.md (or your agent's skills folder).
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.

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}.


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
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
ParamTypeDescription
domainstringCompany domain (e.g., stripe.com)
namestringBrand 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
ParamTypeDescription
brandstringBrand name to search for
domainstringFilter to specific domain
limitintNumber 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
ParamTypeDescription
querystringBrand name
from_datestringStart date
to_datestringEnd date
granularitystringday, 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.

Show full SKILL.md (226 more words)Show less
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

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

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

© OpenClaudia, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/brand-monitor of OpenClaudia/openclaudia-skills.

Open the folder on GitHubat commit 28bf209

Compare with similar skills

Brand Monitor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Brand Monitor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Brand Monitor this skillOpenClaudia/openclaudia-skills713—~2.1kAutomated safety check: NotesMIT
Brand and Design Toolkitnextlevelbuilder/ui-ux-pro-max-skill135k1 repos~3.5kAutomated safety check: PassMIT
Anthropic Brand Stylinganthropics/skills180k30 repos~559Automated safety check: PassApache-2.0
Logo Designkaankiziltug/logo-design-skill2.5k—~4.4kAutomated safety check: PassMIT
Logo Generatorop7418/logo-generator-skill2.2k—~1.8kAutomated safety check: NotesNone
Web Asset Generatoralonw0/web-asset-generator5141 repos~6.6kAutomated safety check: PassMIT

Similar skills

  • Brand and Design Toolkit

    nextlevelbuilder/ui-ux-pro-max-skill

    Bundles design tasks behind one skill: brand identity, tokens, UI styling, logos, corporate identity mockups, slides, banners, icons and social images.

    135k GitHub starsUsed in 1 repo~3.5k tokens
    Media & CreativeAuto-check passed
  • Anthropic Brand Styling

    anthropics/skills

    Official

    Applies Anthropic's brand colors and fonts to artifacts such as PowerPoint slides, using fixed hex values for text and accents, Poppins headings and Lora body text.

    180k GitHub starsUsed in 30 repos~559 tokens
    Media & CreativeAuto-check passed
  • Logo Design

    kaankiziltug/logo-design-skill

    Professional logo and brand-mark design, from brief to production files.

    2.5k GitHub stars~4.4k tokensUpdated 10 days ago
    Media & CreativeAuto-check passed
  • Logo Generator

    op7418/logo-generator-skill

    Generate professional SVG logos and high-end showcase images.

    2.2k GitHub stars~1.8k tokensUpdated 5 mo ago
    Media & CreativeAuto-check: notes
  • Web Asset Generator

    alonw0/web-asset-generator

    Generate web assets including favicons, app icons (PWA), and social media meta images (Open Graph) for Facebook, Twitter, WhatsApp, and LinkedIn.

    514 GitHub starsUsed in 1 repo~6.6k tokens
    Media & CreativeAuto-check passed
  • Image Generation

    onyx-dot-app/onyx

    Generate or edit raster images (photos, illustrations, textures, sprites, mockups, logos, infographics) using the workspace's configured image-generation provider via onyx-cli image.

    32k GitHub starsUsed in 1 repo~1.7k tokens
    Media & CreativeAuto-check passed

More from OpenClaudia/openclaudia-skills

All 74 skills in this repo
  • Competitor Traffic Report

    OpenClaudia/openclaudia-skills

    Build an interactive competitive-traffic report for any company and its rivals — monthly visits (SimilarWeb), organic search traffic and Domain Rating (Ahrefs) — as one self-contained HTML page with…

    713 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Geo Difficulty

    OpenClaudia/openclaudia-skills

    Score how hard a keyword is to rank for in the AI-search era — page-level URL Rating of real competitors (not just domain DR), Ahrefs keyword difficulty, and whether a given site already ranks or is…

    713 GitHub stars~694 tokensUpdated today
    Auto-check passed
  • Gsc Portfolio Audit

    OpenClaudia/openclaudia-skills

    Audit EVERY Google Search Console property at once — rank all sites by clicks and impressions with period-over-period deltas, then diff keywords per site to surface what is newly ranking, rising…

    713 GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Similarweb Traffic

    OpenClaudia/openclaudia-skills

    Fetch website traffic estimates (monthly visits, traffic sources, top countries, keywords, engagement, ranks) for any domain from SimilarWeb.

    713 GitHub stars~882 tokensUpdated today
    Auto-check passed
  • Ahrefs Python

    OpenClaudia/openclaudia-skills

    Manages Ahrefs API usage in Python using ahrefs-python library.

    713 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Ab Test Setup

    OpenClaudia/openclaudia-skills

    Design, plan, and analyze A/B tests with statistical rigor. An agent skill from OpenClaudia/openclaudia-skills.

    713 GitHub stars~1.7k tokensUpdated today
    Auto-check passed

Questions about Brand Monitor

What does Brand Monitor do?

Brand monitoring and mention tracking via the Brand.dev API. Brand Monitor is an agent skill from OpenClaudia/openclaudia-skills.dev API.

When should I use Brand Monitor?

Brand Monitor fits situations like: asked to monitor brand mentions; track sentiment; find PR opportunities; detect logo usage.

How do I install Brand Monitor in Claude Code?

Run `npx skills add OpenClaudia/openclaudia-skills --skill brand-monitor -a claude-code`. Or copy the skill folder (skills/brand-monitor in OpenClaudia/openclaudia-skills) into .claude/skills/brand-monitor in your project. Claude Code loads it when a task matches its description.

How do I install Brand Monitor in Codex?

Run `npx skills add OpenClaudia/openclaudia-skills --skill brand-monitor -a codex`. Or copy the skill folder (skills/brand-monitor in OpenClaudia/openclaudia-skills) into .agents/skills/brand-monitor in your project. Codex loads it when a task matches its description.

Can I use Brand Monitor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add OpenClaudia/openclaudia-skills --skill brand-monitor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/brand-monitor, .gemini/skills/brand-monitor, .github/skills/brand-monitor and .opencode/skills/brand-monitor in your project.

What does Brand Monitor need to run?

Going by SKILL.md and its folder, Brand Monitor needs the command-line tools its instructions call (curl and python3) and credentials named BRANDDEV_API_KEY. Our summary lists: Python 3; A credential in BRANDDEV_API_KEY.

Does Brand Monitor access the network?

SKILL.md names 2 domains. In commands or code: api.brand.dev; the agent is likely to contact it when it follows the instructions. As links in the text: brand.dev. This is read from the text; nothing was executed.

Is Brand Monitor safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Brand Monitor use?

Brand Monitor is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Brand Monitor use?

About 2.1k tokens (SKILL.md is roughly 8.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Brand Monitor?

Skills that share tags, products or a category with Brand Monitor: Brand and Design Toolkit (nextlevelbuilder/ui-ux-pro-max-skill, 135k stars), Anthropic Brand Styling (anthropics/skills, 180k stars), Logo Design (kaankiziltug/logo-design-skill, 2.5k stars) and Logo Generator (op7418/logo-generator-skill, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Brand Monitor?

OpenClaudia (a GitHub organization) maintains it in OpenClaudia/openclaudia-skills, which has 713 GitHub stars. The repository holds 74 skills in this directory. The repository was last updated on September 18, 2026.

Source: OpenClaudia/openclaudia-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.