From 89999110a2ee869330064ee64470edc694b5b195 Mon Sep 17 00:00:00 2001 From: Corey Haines <34802794+coreyhaines31@users.noreply.github.com> Date: Wed, 18 Mar 2026 12:13:42 -0700 Subject: [PATCH] feat: add Resend CLI docs and Firehose integration MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 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 --- tools/REGISTRY.md | 1 + tools/integrations/firehose.md | 159 +++++++++++++++++++++++++++++++++ tools/integrations/resend.md | 46 +++++++++- 3 files changed, 205 insertions(+), 1 deletion(-) create mode 100644 tools/integrations/firehose.md diff --git a/tools/REGISTRY.md b/tools/REGISTRY.md index dbad514..cd0175e 100644 --- a/tools/REGISTRY.md +++ b/tools/REGISTRY.md @@ -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) | diff --git a/tools/integrations/firehose.md b/tools/integrations/firehose.md new file mode 100644 index 0000000..2b51ec4 --- /dev/null +++ b/tools/integrations/firehose.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 diff --git a/tools/integrations/resend.md b/tools/integrations/resend.md index 75af93d..23e0e53 100644 --- a/tools/integrations/resend.md +++ b/tools/integrations/resend.md @@ -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 + +# List domains +resend domains list + +# Add a domain +resend domains create --name example.com + +# Verify a domain +resend domains verify + +# 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