marketingskills/tools/integrations/firehose.md

Firehose

Real-time web data streaming API that monitors web pages and delivers matching content instantly via server-sent events (SSE). Built for competitive intelligence, brand monitoring, and news tracking without polling.

Capabilities

Integration	Available	Notes
API	✓	RESTful endpoints for managing rules + SSE for streaming
MCP	-	Not available
CLI	-	Not available
SDK	-	Native AI agent skill available

Authentication

• Type: API Key
• Currently: Free beta — no credit card required
• Get access: Sign up at firehose.com

Core Concepts

Rules — Filters that define what content to match. Uses Lucene query syntax.

Stream — A server-sent event (SSE) connection that delivers matching content in real-time as it's published on the web.

Instead of polling an endpoint on a schedule, you define rules once and receive a continuous stream of matches as they happen.

Query Syntax (Lucene)

# Exact phrase
"your brand name"

# Field-specific
title:tesla
domain:reuters.com
domain:techcrunch.com

# Boolean operators
"Series A" AND (SaaS OR software)
competitor OR "competitor name" NOT "your company"

# Wildcard
market* AND funding

# Language filter
language:en

# Date range
publish_time:[2026-01-01 TO 2026-03-18]

# ML-classified categories
category:finance
category:technology

Common Agent Operations

Create a monitoring rule

POST https://api.firehose.com/rules

{
  "query": "\"your brand name\" OR \"your product name\"",
  "label": "brand-mentions"
}

List active rules

GET https://api.firehose.com/rules

Delete a rule

DELETE https://api.firehose.com/rules/{rule_id}

Connect to the stream

GET https://api.firehose.com/stream
Authorization: Bearer {api_key}

# Returns server-sent events:
# data: {"url": "...", "title": "...", "publish_time": "...", "matched_rule": "..."}

Example: Node.js stream consumer

import EventSource from 'eventsource';

const stream = new EventSource('https://api.firehose.com/stream', {
  headers: { Authorization: `Bearer ${process.env.FIREHOSE_API_KEY}` }
});

stream.onmessage = (event) => {
  const item = JSON.parse(event.data);
  console.log(`[${item.matched_rule}] ${item.title} — ${item.url}`);
};

Use Cases for Marketing

Competitive intelligence

Monitor competitors' press coverage, product announcements, and funding news in real-time.

query: "CompetitorName" AND (launch OR funding OR "product update" OR partnership)

Brand monitoring

Track mentions of your brand across news and web content.

query: "YourBrand" OR "YourProductName" NOT site:yourdomain.com

Category / market news

Stay current on your market without manually checking sources.

query: category:technology AND ("no-code" OR "low-code") AND funding
domain:techcrunch.com OR domain:venturebeat.com

Lead trigger monitoring

Track signals that indicate a prospect is ready to buy (hiring, funding, tool mentions).

query: ("hiring" OR "we're growing") AND "RevOps" AND (HubSpot OR Salesforce)

PR and link building

Get alerted when publications cover topics in your space, enabling timely outreach.

query: "best [category] tools" OR "top [category] software" AND publish_time:[now-7d TO now]

When to Use

• Real-time competitive intelligence (faster than Google Alerts)
• Brand mention monitoring across news and web
• Market signal tracking for sales prospecting
• Automated content curation pipelines
• Trigger-based workflows (new mention → Slack alert, CRM update, etc.)

Relevant Skills

• competitors
• customer-research
• content-strategy
• cold-email
• marketing-ideas