feat: add Resend CLI docs and Firehose integration
- resend.md: update CLI availability (now official), add CLI install, setup, and common commands section - firehose.md: new integration guide for real-time web content streaming API — query syntax, stream setup, marketing use cases (brand monitoring, competitive intel, lead triggers, PR/link building) - REGISTRY.md: add firehose under Competitive Intelligence Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -71,6 +71,7 @@ Quick reference for AI agents to discover tool capabilities and integration meth
|
|||||||
| crossbeam | Partner Ecosystem | ✓ | ✓ | [✓](clis/crossbeam.js) | - | [crossbeam.md](integrations/crossbeam.md) |
|
| crossbeam | Partner Ecosystem | ✓ | ✓ | [✓](clis/crossbeam.js) | - | [crossbeam.md](integrations/crossbeam.md) |
|
||||||
| pendo | Product Analytics | ✓ | - | [✓](clis/pendo.js) | - | [pendo.md](integrations/pendo.md) |
|
| pendo | Product Analytics | ✓ | - | [✓](clis/pendo.js) | - | [pendo.md](integrations/pendo.md) |
|
||||||
| similarweb | Competitive Intelligence | ✓ | - | [✓](clis/similarweb.js) | - | [similarweb.md](integrations/similarweb.md) |
|
| similarweb | Competitive Intelligence | ✓ | - | [✓](clis/similarweb.js) | - | [similarweb.md](integrations/similarweb.md) |
|
||||||
|
| firehose | Competitive Intelligence | ✓ | - | - | - | [firehose.md](integrations/firehose.md) |
|
||||||
| airops | AI Content | ✓ | - | [✓](clis/airops.js) | - | [airops.md](integrations/airops.md) |
|
| airops | AI Content | ✓ | - | [✓](clis/airops.js) | - | [airops.md](integrations/airops.md) |
|
||||||
| buffer | Social | ✓ | - | [✓](clis/buffer.js) | - | [buffer.md](integrations/buffer.md) |
|
| buffer | Social | ✓ | - | [✓](clis/buffer.js) | - | [buffer.md](integrations/buffer.md) |
|
||||||
| wistia | Video | ✓ | - | [✓](clis/wistia.js) | - | [wistia.md](integrations/wistia.md) |
|
| wistia | Video | ✓ | - | [✓](clis/wistia.js) | - | [wistia.md](integrations/wistia.md) |
|
||||||
|
|||||||
@@ -0,0 +1,159 @@
|
|||||||
|
# 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
|
||||||
|
|
||||||
|
```bash
|
||||||
|
POST https://api.firehose.com/rules
|
||||||
|
|
||||||
|
{
|
||||||
|
"query": "\"your brand name\" OR \"your product name\"",
|
||||||
|
"label": "brand-mentions"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### List active rules
|
||||||
|
|
||||||
|
```bash
|
||||||
|
GET https://api.firehose.com/rules
|
||||||
|
```
|
||||||
|
|
||||||
|
### Delete a rule
|
||||||
|
|
||||||
|
```bash
|
||||||
|
DELETE https://api.firehose.com/rules/{rule_id}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Connect to the stream
|
||||||
|
|
||||||
|
```bash
|
||||||
|
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
|
||||||
|
|
||||||
|
```javascript
|
||||||
|
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
|
||||||
|
|
||||||
|
- competitor-alternatives
|
||||||
|
- customer-research
|
||||||
|
- content-strategy
|
||||||
|
- cold-email
|
||||||
|
- marketing-ideas
|
||||||
@@ -8,7 +8,7 @@ Developer-friendly transactional email service with modern API.
|
|||||||
|-------------|-----------|-------|
|
|-------------|-----------|-------|
|
||||||
| API | ✓ | Simple REST API for sending emails |
|
| API | ✓ | Simple REST API for sending emails |
|
||||||
| MCP | ✓ | Available via Resend MCP server |
|
| MCP | ✓ | Available via Resend MCP server |
|
||||||
| CLI | - | Not available |
|
| CLI | ✓ | Official Resend CLI |
|
||||||
| SDK | ✓ | Official SDKs for Node.js, Python, Go, etc. |
|
| SDK | ✓ | Official SDKs for Node.js, Python, Go, etc. |
|
||||||
|
|
||||||
## Authentication
|
## Authentication
|
||||||
@@ -17,6 +17,49 @@ Developer-friendly transactional email service with modern API.
|
|||||||
- **Header**: `Authorization: Bearer {api_key}`
|
- **Header**: `Authorization: Bearer {api_key}`
|
||||||
- **Get key**: API Keys section in Resend dashboard
|
- **Get key**: API Keys section in Resend dashboard
|
||||||
|
|
||||||
|
## CLI
|
||||||
|
|
||||||
|
### Install
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm install -g resend-cli
|
||||||
|
```
|
||||||
|
|
||||||
|
### Setup
|
||||||
|
|
||||||
|
```bash
|
||||||
|
resend login
|
||||||
|
# or set env var: RESEND_API_KEY=re_xxx
|
||||||
|
```
|
||||||
|
|
||||||
|
### Common commands
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# Send a test email
|
||||||
|
resend emails send --from hello@example.com --to user@example.com --subject "Test" --text "Hello"
|
||||||
|
|
||||||
|
# List recent emails
|
||||||
|
resend emails list
|
||||||
|
|
||||||
|
# Get email status
|
||||||
|
resend emails get <email_id>
|
||||||
|
|
||||||
|
# List domains
|
||||||
|
resend domains list
|
||||||
|
|
||||||
|
# Add a domain
|
||||||
|
resend domains create --name example.com
|
||||||
|
|
||||||
|
# Verify a domain
|
||||||
|
resend domains verify <domain_id>
|
||||||
|
|
||||||
|
# List API keys
|
||||||
|
resend api-keys list
|
||||||
|
|
||||||
|
# Create an API key
|
||||||
|
resend api-keys create --name "Production"
|
||||||
|
```
|
||||||
|
|
||||||
## Common Agent Operations
|
## Common Agent Operations
|
||||||
|
|
||||||
### Send email
|
### Send email
|
||||||
@@ -155,6 +198,7 @@ await resend.emails.send({
|
|||||||
- Receipt and notification emails
|
- Receipt and notification emails
|
||||||
- Developer-friendly email integration
|
- Developer-friendly email integration
|
||||||
- React-based email templates
|
- React-based email templates
|
||||||
|
- Quick CLI testing of email flows without writing code
|
||||||
|
|
||||||
## Rate Limits
|
## Rate Limits
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user