brand-mention-research

Brand mention research

Access and scope

Set CRAWLORA_API_KEY to your Crawlora key. Prefer the listed Crawlora MCP tools when connected; otherwise use the bundled scripts/crawlora.sh, which sends x-api-key to https://api.crawlora.net/api/v1. Read reference/endpoints.md for exact methods and parameters. Check application code as well as HTTP status; payloads are inside data. Stop on authentication errors, back off on 429, and retry a transient upstream failure once. Bound pages and calls by the requested scope and credit budget. Preserve source IDs, URLs, retrieval times, and source dates where supplied.

Produce a bounded mention brief for a brand, product, or campaign. Define the entity and aliases, competitors when requested, date window, languages/markets, platforms, and page budget before collecting. Common names need corroborating product, domain, handle, or contextual evidence to avoid false matches. Start with a small sample for each query. If broad Reddit or platform search results are mostly unrelated, tighten the exact terms or select a relevant community; do not treat returned-result counts as mention volume or continue paging through a low-precision query.

Collect and classify attributable mentions

• Search Reddit, TikTok, or YouTube according to the requested sources. Retain query/alias, filters, result order, pages/cursors, and retrieval time. Reddit's time filter applies to top/comments sorts; do not claim sort=new time=week enforces a week. TikTok has no date-filter argument here: filter returned dates locally and mark unknown dates rather than inventing a backend filter. YouTube uses its documented upload_date and locale/region fields.
• Resolve selected results into post/video detail. Canonical post IDs are the within-platform deduplication key. Cross-posted or quoted content can be linked as related observations, but identical text does not prove the same author.
• Fetch comments only for selected relevant posts. Preserve parent post, comment identity when available, ordering, and pagination. Keep comment counts/sample size separate from top-level post counts. Reddit's metrics mode costs more; request it only when engagement data is needed. Missing engagement remains unknown.
• Label each observation as a confirmed mention, ambiguous match, promotional mention, quotation, or excluded false positive with a reason. Interpret sentiment from available text/context; use mixed or unknown for sarcasm, missing content, or uncertain intent. Do not invent video dialogue from a caption alone.

scripts/crawlora.sh /reddit/search q="Crawlora" sort=top time=month limit=25
scripts/crawlora.sh /tiktok/search keyword="Crawlora" count=10
scripts/crawlora.sh /youtube/search q="Crawlora" type=video upload_date=this_month
# Resolve returned IDs before requesting selected details/comments:
# scripts/crawlora.sh "/reddit/comments/$POST_ID" limit=25

Deliver a reproducible brief

Return a coverage ledger and evidence table with platform, source URL/ID, publication time if available, alias/query, short excerpt, theme, sentiment, and explicit selection reason. Show unique confirmed posts, excluded/ambiguous matches, sampled comments, and denominators for each reported proportion. Compare competitors only under equivalent windows and sampling budgets, and still describe unequal platform/search coverage. Do not sum follower counts or views into unique audience reach, infer market share from mention counts, or call a sampled issue widespread without corroborating evidence. Repeated runs need the same saved query/scope to support change claims. Do not contact authors, post responses, or schedule monitoring unless the user requests those actions.