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) |
|
||||
| pendo | Product Analytics | ✓ | - | [✓](clis/pendo.js) | - | [pendo.md](integrations/pendo.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) |
|
||||
| buffer | Social | ✓ | - | [✓](clis/buffer.js) | - | [buffer.md](integrations/buffer.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 |
|
||||
| MCP | ✓ | Available via Resend MCP server |
|
||||
| CLI | - | Not available |
|
||||
| CLI | ✓ | Official Resend CLI |
|
||||
| SDK | ✓ | Official SDKs for Node.js, Python, Go, etc. |
|
||||
|
||||
## Authentication
|
||||
@@ -17,6 +17,49 @@ Developer-friendly transactional email service with modern API.
|
||||
- **Header**: `Authorization: Bearer {api_key}`
|
||||
- **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
|
||||
|
||||
### Send email
|
||||
@@ -155,6 +198,7 @@ await resend.emails.send({
|
||||
- Receipt and notification emails
|
||||
- Developer-friendly email integration
|
||||
- React-based email templates
|
||||
- Quick CLI testing of email flows without writing code
|
||||
|
||||
## Rate Limits
|
||||
|
||||
|
||||
Reference in New Issue
Block a user