tinyfish-social-listening

Social Listening with TinyFish

Track brand mentions, sentiment, and industry chatter across the live web — forums, blogs, news, social platforms, and developer communities — using TinyFish Search and Fetch.

First step: If the user already named the brand/topic, proceed directly. Otherwise, ask. Default time window: Last 7 days. Always link every claim to its source URL.

When To Use

• User wants to know what people are saying about a brand, product, person, or topic.
• User asks to monitor competitors or compare share of voice.
• User wants sentiment analysis on a launch, feature, controversy, or trend.
• User says "social listening," "brand monitoring," "reputation check," "buzz check," or "what's the internet saying about X."
• User wants a recurring pulse on public perception (pair with a cron job).

Pre-flight Check (REQUIRED)

# 1. TinyFish CLI installed?
which tinyfish && tinyfish --version || echo "TINYFISH_CLI_NOT_INSTALLED"

# 2. Authenticated?
tinyfish auth status

If CLI is not available, fall back to the TinyFish API with TINYFISH_API_KEY:

test -n "$TINYFISH_API_KEY" && echo "API_KEY_AVAILABLE" || echo "NO_TINYFISH_ACCESS"

If neither works, stop and tell the user to install or authenticate.

---

Core Workflow

Step 1 — Identify the target

If the user already named the brand/topic, skip asking and proceed. Otherwise, ask what brand, product, or topic they want to research. Then set:

• Target entity: Whatever the user specifies.
• Time focus: Last 7 days. All search queries MUST include date constraints.
• Channels: Reddit, Hacker News, Twitter/X, LinkedIn, blogs, news, GitHub, forums, YouTube.
• Sentiment lens: General pulse.

⚠️ CRITICAL: STRICT 7-DAY ENFORCEMENT ⚠️ Search engines regularly return results older than 7 days regardless of date constraints in queries. You MUST:

1. Check the published_date field on every fetched result
2. Check date indicators in Reddit posts (e.g., "7d ago", "2mo ago") and other platforms
3. DISCARD any result older than 7 days from today — do NOT include it in the report, do NOT quote it, do NOT use it for sentiment classification
4. If most results are older than 7 days, say so honestly: "Limited discussion found in the last 7 days"
5. NEVER silently widen the window — if the 7-day window is thin, report that it's thin
6. In the final report, every source MUST have its date stated. Any source without a verifiable date within the last 7 days gets excluded.