feat: add 10 new CLI tools and integration guides from Claude connectors
New tools: Clay, Outreach, ZoomInfo, Close, Pendo, Similarweb, Supermetrics, AirOps, Crossbeam, and Coupler.io. Each includes a zero-dependency Node.js CLI and an integration guide. Updates REGISTRY.md with new tool index entries, categories, and MCP-enabled tools list. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,128 @@
|
||||
# AirOps
|
||||
|
||||
AI content platform for crafting content that wins AI search. Build and execute AI workflows (flows) for SEO content generation, data enrichment, and automation.
|
||||
|
||||
## Capabilities
|
||||
|
||||
| Integration | Available | Notes |
|
||||
|-------------|-----------|-------|
|
||||
| API | ✓ | Flows, Workflows, Runs |
|
||||
| MCP | - | Not available |
|
||||
| CLI | ✓ | [airops.js](../clis/airops.js) |
|
||||
| SDK | - | REST API only |
|
||||
|
||||
## Authentication
|
||||
|
||||
- **Type**: API Key + Workspace ID
|
||||
- **Header**: `Authorization: Bearer {api_key}`
|
||||
- **Env vars**: `AIROPS_API_KEY`, `AIROPS_WORKSPACE_ID`
|
||||
- **Get key**: Settings > API Keys at https://app.airops.com
|
||||
|
||||
## Common Agent Operations
|
||||
|
||||
### List Flows
|
||||
|
||||
```bash
|
||||
GET https://api.airops.com/v1/workspaces/{workspace_id}/flows
|
||||
```
|
||||
|
||||
### Get Flow Details
|
||||
|
||||
```bash
|
||||
GET https://api.airops.com/v1/workspaces/{workspace_id}/flows/{flow_id}
|
||||
```
|
||||
|
||||
### Execute a Flow
|
||||
|
||||
```bash
|
||||
POST https://api.airops.com/v1/workspaces/{workspace_id}/flows/{flow_id}/execute
|
||||
|
||||
{
|
||||
"inputs": {
|
||||
"keyword": "best project management tools",
|
||||
"target_audience": "startup founders"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### List Runs for a Flow
|
||||
|
||||
```bash
|
||||
GET https://api.airops.com/v1/workspaces/{workspace_id}/flows/{flow_id}/runs
|
||||
```
|
||||
|
||||
### Get Run Status
|
||||
|
||||
```bash
|
||||
GET https://api.airops.com/v1/workspaces/{workspace_id}/runs/{run_id}
|
||||
```
|
||||
|
||||
### List Workflows
|
||||
|
||||
```bash
|
||||
GET https://api.airops.com/v1/workspaces/{workspace_id}/workflows
|
||||
```
|
||||
|
||||
### Execute a Workflow
|
||||
|
||||
```bash
|
||||
POST https://api.airops.com/v1/workspaces/{workspace_id}/workflows/{workflow_id}/execute
|
||||
|
||||
{
|
||||
"inputs": {
|
||||
"topic": "email marketing best practices",
|
||||
"content_type": "blog_post"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Key Metrics
|
||||
|
||||
### Flow Data
|
||||
- `id` - Flow identifier
|
||||
- `name` - Flow name
|
||||
- `description` - Flow description
|
||||
- `status` - Active/inactive status
|
||||
- `created_at` - Creation timestamp
|
||||
- `updated_at` - Last modified timestamp
|
||||
|
||||
### Run Data
|
||||
- `id` - Run identifier
|
||||
- `flow_id` - Parent flow ID
|
||||
- `status` - pending, running, completed, failed
|
||||
- `inputs` - Input parameters used
|
||||
- `outputs` - Generated results
|
||||
- `started_at` - Run start time
|
||||
- `completed_at` - Run completion time
|
||||
|
||||
## Parameters
|
||||
|
||||
### Flow Execution
|
||||
- `inputs` - JSON object of key-value pairs matching the flow's expected inputs
|
||||
- Input keys vary per flow (e.g., `keyword`, `topic`, `url`, `target_audience`)
|
||||
|
||||
### Workflow Execution
|
||||
- `inputs` - JSON object of key-value pairs matching the workflow's expected inputs
|
||||
|
||||
## When to Use
|
||||
|
||||
- Bulk content generation for SEO at scale
|
||||
- SEO-optimized article creation with AI workflows
|
||||
- Data enrichment pipelines for marketing lists
|
||||
- Keyword research automation
|
||||
- Content optimization and rewriting
|
||||
- Programmatic SEO page generation
|
||||
- AI-powered content briefs and outlines
|
||||
|
||||
## Rate Limits
|
||||
|
||||
- Rate limits vary by plan
|
||||
- Concurrent execution limits depend on workspace tier
|
||||
- Check AirOps dashboard for current usage and limits
|
||||
|
||||
## Relevant Skills
|
||||
|
||||
- ai-seo
|
||||
- content-strategy
|
||||
- programmatic-seo
|
||||
- copywriting
|
||||
@@ -0,0 +1,149 @@
|
||||
# Clay
|
||||
|
||||
Data enrichment and outbound automation platform for building lead lists with waterfall enrichment across 75+ data providers.
|
||||
|
||||
## Capabilities
|
||||
|
||||
| Integration | Available | Notes |
|
||||
|-------------|-----------|-------|
|
||||
| API | ✓ | Tables, People Enrichment, Company Enrichment |
|
||||
| MCP | ✓ | [Claude connector](https://claude.com/connectors/clay) |
|
||||
| CLI | ✓ | [clay.js](../clis/clay.js) |
|
||||
| SDK | - | REST API only |
|
||||
|
||||
## Authentication
|
||||
|
||||
- **Type**: API Key (Bearer token)
|
||||
- **Header**: `Authorization: Bearer {api_key}`
|
||||
- **Get key**: Settings > API at https://app.clay.com
|
||||
|
||||
## Common Agent Operations
|
||||
|
||||
### List Tables
|
||||
|
||||
```bash
|
||||
GET https://api.clay.com/v3/tables
|
||||
|
||||
Authorization: Bearer {api_key}
|
||||
```
|
||||
|
||||
### Get Table Details
|
||||
|
||||
```bash
|
||||
GET https://api.clay.com/v3/tables/{table_id}
|
||||
|
||||
Authorization: Bearer {api_key}
|
||||
```
|
||||
|
||||
### Get Table Rows
|
||||
|
||||
```bash
|
||||
GET https://api.clay.com/v3/tables/{table_id}/rows?page=1&per_page=25
|
||||
|
||||
Authorization: Bearer {api_key}
|
||||
```
|
||||
|
||||
### Add Row to Table
|
||||
|
||||
```bash
|
||||
POST https://api.clay.com/v3/tables/{table_id}/rows
|
||||
|
||||
{
|
||||
"first_name": "Jane",
|
||||
"last_name": "Doe",
|
||||
"company": "Acme Inc",
|
||||
"email": "jane@acme.com"
|
||||
}
|
||||
```
|
||||
|
||||
### People Enrichment
|
||||
|
||||
```bash
|
||||
POST https://api.clay.com/v3/people/enrich
|
||||
|
||||
{
|
||||
"email": "jane@acme.com"
|
||||
}
|
||||
```
|
||||
|
||||
### Company Enrichment
|
||||
|
||||
```bash
|
||||
POST https://api.clay.com/v3/companies/enrich
|
||||
|
||||
{
|
||||
"domain": "acme.com"
|
||||
}
|
||||
```
|
||||
|
||||
## Key Metrics
|
||||
|
||||
### Person Data
|
||||
- `first_name`, `last_name` - Name
|
||||
- `email` - Email address
|
||||
- `title` - Job title
|
||||
- `linkedin_url` - LinkedIn profile
|
||||
- `company` - Company name
|
||||
- `location` - Location
|
||||
- `seniority` - Seniority level
|
||||
|
||||
### Company Data
|
||||
- `name` - Company name
|
||||
- `domain` - Website domain
|
||||
- `industry` - Industry
|
||||
- `employee_count` - Number of employees
|
||||
- `revenue` - Estimated revenue
|
||||
- `location` - Headquarters location
|
||||
- `technologies` - Tech stack
|
||||
- `description` - Company description
|
||||
|
||||
### Table Data
|
||||
- `id` - Table ID
|
||||
- `name` - Table name
|
||||
- `row_count` - Number of rows
|
||||
- `columns` - Column definitions
|
||||
- `created_at` - Creation timestamp
|
||||
- `updated_at` - Last update timestamp
|
||||
|
||||
## Parameters
|
||||
|
||||
### Tables
|
||||
- `page` - Page number (default: 1)
|
||||
- `per_page` - Results per page (default: 25)
|
||||
|
||||
### People Enrichment
|
||||
- `email` - Email address
|
||||
- `linkedin_url` - LinkedIn profile URL
|
||||
- `first_name` + `last_name` - Name-based lookup
|
||||
|
||||
### Company Enrichment
|
||||
- `domain` - Company domain (e.g., "acme.com")
|
||||
|
||||
### Add Row
|
||||
- Fields are dynamic and match the table's column definitions
|
||||
- Pass data as key-value pairs matching column names
|
||||
|
||||
## When to Use
|
||||
|
||||
- Building enriched prospect lists with waterfall enrichment across multiple providers
|
||||
- Enriching leads with person and company data from 75+ sources
|
||||
- Automating outbound workflows with enriched data
|
||||
- Finding verified contact info (emails, phone numbers, social profiles)
|
||||
- Company research and firmographic analysis
|
||||
- Triggering enrichment workflows via webhooks
|
||||
- Syncing enriched data back to CRM or outbound tools
|
||||
|
||||
## Rate Limits
|
||||
|
||||
- Rate limits vary by plan
|
||||
- Standard: 100 requests/minute
|
||||
- Enterprise plans have higher limits
|
||||
- Enrichment credits consumed per lookup vary by data provider
|
||||
- Webhook endpoints accept data continuously
|
||||
|
||||
## Relevant Skills
|
||||
|
||||
- cold-email
|
||||
- revops
|
||||
- sales-enablement
|
||||
- competitor-alternatives
|
||||
@@ -0,0 +1,191 @@
|
||||
# Close
|
||||
|
||||
Sales CRM for SMBs with built-in calling, email, and pipeline management designed for high-velocity sales teams.
|
||||
|
||||
## Capabilities
|
||||
|
||||
| Integration | Available | Notes |
|
||||
|-------------|-----------|-------|
|
||||
| API | ✓ | Leads, Contacts, Opportunities, Activities, Tasks |
|
||||
| MCP | - | Not available |
|
||||
| CLI | ✓ | [close.js](../clis/close.js) |
|
||||
| SDK | - | REST API only |
|
||||
|
||||
## Authentication
|
||||
|
||||
- **Type**: Basic Auth
|
||||
- **Header**: `Authorization: Basic {base64(api_key + ':')}`
|
||||
- **Get key**: Settings > API Keys at https://app.close.com
|
||||
|
||||
## Common Agent Operations
|
||||
|
||||
### List Leads
|
||||
|
||||
```bash
|
||||
GET https://api.close.com/api/v1/lead/
|
||||
|
||||
Authorization: Basic {base64(api_key + ':')}
|
||||
```
|
||||
|
||||
### Search Leads
|
||||
|
||||
```bash
|
||||
GET https://api.close.com/api/v1/lead/?query=company_name
|
||||
|
||||
Authorization: Basic {base64(api_key + ':')}
|
||||
```
|
||||
|
||||
### Create Lead
|
||||
|
||||
```bash
|
||||
POST https://api.close.com/api/v1/lead/
|
||||
|
||||
{
|
||||
"name": "Acme Corp",
|
||||
"url": "https://acme.com",
|
||||
"description": "Enterprise prospect"
|
||||
}
|
||||
```
|
||||
|
||||
### Get Contact
|
||||
|
||||
```bash
|
||||
GET https://api.close.com/api/v1/contact/{contact_id}/
|
||||
|
||||
Authorization: Basic {base64(api_key + ':')}
|
||||
```
|
||||
|
||||
### Create Contact
|
||||
|
||||
```bash
|
||||
POST https://api.close.com/api/v1/contact/
|
||||
|
||||
{
|
||||
"lead_id": "lead_xxx",
|
||||
"name": "Jane Smith",
|
||||
"emails": [{ "email": "jane@acme.com", "type": "office" }],
|
||||
"phones": [{ "phone": "+15551234567", "type": "office" }]
|
||||
}
|
||||
```
|
||||
|
||||
### Create Opportunity
|
||||
|
||||
```bash
|
||||
POST https://api.close.com/api/v1/opportunity/
|
||||
|
||||
{
|
||||
"lead_id": "lead_xxx",
|
||||
"value": 50000,
|
||||
"status_type": "active"
|
||||
}
|
||||
```
|
||||
|
||||
### List Activities
|
||||
|
||||
```bash
|
||||
GET https://api.close.com/api/v1/activity/?lead_id=lead_xxx
|
||||
|
||||
Authorization: Basic {base64(api_key + ':')}
|
||||
```
|
||||
|
||||
### Create Task
|
||||
|
||||
```bash
|
||||
POST https://api.close.com/api/v1/task/
|
||||
|
||||
{
|
||||
"lead_id": "lead_xxx",
|
||||
"text": "Follow up on demo request",
|
||||
"_type": "lead",
|
||||
"date": "2026-03-10"
|
||||
}
|
||||
```
|
||||
|
||||
## Key Metrics
|
||||
|
||||
### Lead Data
|
||||
- `id` - Lead ID
|
||||
- `display_name` - Lead name
|
||||
- `url` - Website URL
|
||||
- `description` - Lead description
|
||||
- `status_id` - Pipeline status
|
||||
- `contacts` - Associated contacts
|
||||
- `opportunities` - Associated opportunities
|
||||
- `tasks` - Associated tasks
|
||||
|
||||
### Contact Data
|
||||
- `id` - Contact ID
|
||||
- `lead_id` - Parent lead
|
||||
- `name` - Full name
|
||||
- `title` - Job title
|
||||
- `emails` - Email addresses array
|
||||
- `phones` - Phone numbers array
|
||||
|
||||
### Opportunity Data
|
||||
- `id` - Opportunity ID
|
||||
- `lead_id` - Parent lead
|
||||
- `value` - Value in cents
|
||||
- `status_type` - active, won, or lost
|
||||
- `confidence` - Win probability (0-100)
|
||||
- `date_won` - Close date
|
||||
|
||||
### Task Data
|
||||
- `id` - Task ID
|
||||
- `lead_id` - Parent lead
|
||||
- `text` - Task description
|
||||
- `assigned_to` - Assigned user ID
|
||||
- `date` - Due date
|
||||
- `is_complete` - Completion status
|
||||
|
||||
## Parameters
|
||||
|
||||
### Leads
|
||||
- `query` - Search query string
|
||||
- `_skip` - Number of results to skip (pagination)
|
||||
- `_limit` - Max results to return (default: 100)
|
||||
- `_fields` - Comma-separated fields to return
|
||||
|
||||
### Contacts
|
||||
- `lead_id` - Filter by parent lead
|
||||
- `_skip` - Pagination offset
|
||||
- `_limit` - Max results
|
||||
|
||||
### Opportunities
|
||||
- `lead_id` - Filter by parent lead
|
||||
- `status` - Filter by status type (active, won, lost)
|
||||
- `_skip` - Pagination offset
|
||||
- `_limit` - Max results
|
||||
|
||||
### Activities
|
||||
- `lead_id` - Filter by lead
|
||||
- `_type__type` - Filter by type (Email, Call, Note, SMS, Meeting)
|
||||
- `date_created__gt` - After date
|
||||
- `date_created__lt` - Before date
|
||||
|
||||
### Tasks
|
||||
- `assigned_to` - Filter by user ID
|
||||
- `is_complete` - Filter by completion (true/false)
|
||||
- `lead_id` - Filter by lead
|
||||
- `_type` - Task type (lead)
|
||||
|
||||
## When to Use
|
||||
|
||||
- Managing SMB sales pipelines with high-touch outreach
|
||||
- Tracking sales activities (calls, emails, meetings) per lead
|
||||
- Creating and managing tasks for sales follow-ups
|
||||
- Opportunity tracking and revenue forecasting
|
||||
- Building automated outreach workflows
|
||||
- Sales team performance reporting
|
||||
|
||||
## Rate Limits
|
||||
|
||||
- Rate limits based on organization plan
|
||||
- Standard: ~100 requests/minute
|
||||
- Responses include `X-Rate-Limit-Limit` and `X-Rate-Limit-Remaining` headers
|
||||
- 429 responses include `Retry-After` header
|
||||
|
||||
## Relevant Skills
|
||||
|
||||
- revops
|
||||
- sales-enablement
|
||||
- cold-email
|
||||
@@ -0,0 +1,142 @@
|
||||
# Coupler.io
|
||||
|
||||
Data integration platform that connects marketing, sales, analytics, and e-commerce data sources to destinations like spreadsheets, BI tools, and data warehouses with automated scheduling.
|
||||
|
||||
## Capabilities
|
||||
|
||||
| Integration | Available | Notes |
|
||||
|-------------|-----------|-------|
|
||||
| API | ✓ | Importers, Runs, Sources, Destinations |
|
||||
| MCP | ✓ | [Claude connector](https://claude.com/connectors/coupler-io) |
|
||||
| CLI | ✓ | [coupler.js](../clis/coupler.js) |
|
||||
| SDK | - | REST API only |
|
||||
|
||||
## Authentication
|
||||
|
||||
- **Type**: API Key
|
||||
- **Header**: `Authorization: Bearer {api_key}`
|
||||
- **Get key**: Settings > API at https://app.coupler.io
|
||||
|
||||
## Common Agent Operations
|
||||
|
||||
### List Importers
|
||||
|
||||
```bash
|
||||
GET https://api.coupler.io/v1/importers
|
||||
```
|
||||
|
||||
### Get Importer Details
|
||||
|
||||
```bash
|
||||
GET https://api.coupler.io/v1/importers/{id}
|
||||
```
|
||||
|
||||
### Trigger an Importer Run
|
||||
|
||||
```bash
|
||||
POST https://api.coupler.io/v1/importers/{id}/run
|
||||
```
|
||||
|
||||
### Create an Importer
|
||||
|
||||
```bash
|
||||
POST https://api.coupler.io/v1/importers
|
||||
|
||||
{
|
||||
"source_type": "google_analytics",
|
||||
"destination_type": "google_sheets",
|
||||
"name": "GA4 to Sheets Daily"
|
||||
}
|
||||
```
|
||||
|
||||
### Delete an Importer
|
||||
|
||||
```bash
|
||||
DELETE https://api.coupler.io/v1/importers/{id}
|
||||
```
|
||||
|
||||
### List Runs for an Importer
|
||||
|
||||
```bash
|
||||
GET https://api.coupler.io/v1/importers/{id}/runs
|
||||
```
|
||||
|
||||
### Get Run Details
|
||||
|
||||
```bash
|
||||
GET https://api.coupler.io/v1/runs/{id}
|
||||
```
|
||||
|
||||
### List Available Sources
|
||||
|
||||
```bash
|
||||
GET https://api.coupler.io/v1/sources
|
||||
```
|
||||
|
||||
### List Available Destinations
|
||||
|
||||
```bash
|
||||
GET https://api.coupler.io/v1/destinations
|
||||
```
|
||||
|
||||
## Key Metrics
|
||||
|
||||
### Importer Data
|
||||
- `id` - Importer ID
|
||||
- `name` - Importer name
|
||||
- `source_type` - Source connector type
|
||||
- `destination_type` - Destination connector type
|
||||
- `schedule` - Automation schedule
|
||||
- `status` - Current status
|
||||
- `last_run_at` - Last run timestamp
|
||||
|
||||
### Run Data
|
||||
- `id` - Run ID
|
||||
- `importer_id` - Parent importer
|
||||
- `status` - Run status (pending, running, completed, failed)
|
||||
- `started_at` - Start timestamp
|
||||
- `finished_at` - Finish timestamp
|
||||
- `rows_imported` - Number of rows processed
|
||||
- `error` - Error message if failed
|
||||
|
||||
## Parameters
|
||||
|
||||
### Importer Creation
|
||||
- `source_type` - Source connector (e.g., google_analytics, google_ads, facebook_ads, hubspot, shopify, stripe, airtable)
|
||||
- `destination_type` - Destination connector (e.g., google_sheets, bigquery, snowflake, postgresql)
|
||||
- `name` - Importer name
|
||||
- `schedule` - Automation schedule (e.g., hourly, daily, weekly)
|
||||
|
||||
### Supported Sources
|
||||
- **Analytics**: Google Analytics, Adobe Analytics
|
||||
- **Ads**: Google Ads, Facebook Ads, LinkedIn Ads, TikTok Ads
|
||||
- **CRM**: HubSpot, Salesforce, Pipedrive
|
||||
- **E-commerce**: Shopify, Stripe, WooCommerce
|
||||
- **Other**: Airtable, Google Sheets, BigQuery, MySQL, PostgreSQL
|
||||
|
||||
### Supported Destinations
|
||||
- **Spreadsheets**: Google Sheets, Excel Online
|
||||
- **BI Tools**: Looker Studio, Power BI, Tableau
|
||||
- **Data Warehouses**: BigQuery, Snowflake, Redshift
|
||||
- **Databases**: PostgreSQL, MySQL
|
||||
|
||||
## When to Use
|
||||
|
||||
- Automating marketing data pipelines from ads and analytics platforms
|
||||
- Consolidating multi-channel campaign data into a single destination
|
||||
- Scheduling recurring data syncs from CRM to spreadsheets or BI tools
|
||||
- Building marketing dashboards with fresh data from multiple sources
|
||||
- Exporting e-commerce data for reporting and analysis
|
||||
- Connecting data sources without writing custom ETL code
|
||||
|
||||
## Rate Limits
|
||||
|
||||
- Rate limits vary by plan
|
||||
- Standard: API access available on Professional and higher plans
|
||||
- Importer run frequency depends on plan tier
|
||||
|
||||
## Relevant Skills
|
||||
|
||||
- analytics-tracking
|
||||
- paid-ads
|
||||
- revops
|
||||
@@ -0,0 +1,137 @@
|
||||
# Crossbeam
|
||||
|
||||
Partner ecosystem platform (now part of Reveal) for sharing account data with partners to identify co-sell opportunities, overlapping customers, and partner-sourced pipeline.
|
||||
|
||||
## Capabilities
|
||||
|
||||
| Integration | Available | Notes |
|
||||
|-------------|-----------|-------|
|
||||
| API | ✓ | Partners, Populations, Overlaps, Reports, Threads |
|
||||
| MCP | ✓ | [Claude connector](https://claude.com/connectors/crossbeam) |
|
||||
| CLI | ✓ | [crossbeam.js](../clis/crossbeam.js) |
|
||||
| SDK | - | REST API only |
|
||||
|
||||
## Authentication
|
||||
|
||||
- **Type**: API Key
|
||||
- **Header**: `Authorization: Bearer {api_key}`
|
||||
- **Get key**: Settings > API at https://app.crossbeam.com
|
||||
|
||||
## Common Agent Operations
|
||||
|
||||
### List Partners
|
||||
|
||||
```bash
|
||||
GET https://api.crossbeam.com/v1/partners
|
||||
Authorization: Bearer {api_key}
|
||||
```
|
||||
|
||||
### Get Partner Details
|
||||
|
||||
```bash
|
||||
GET https://api.crossbeam.com/v1/partners/{id}
|
||||
Authorization: Bearer {api_key}
|
||||
```
|
||||
|
||||
### List Populations
|
||||
|
||||
```bash
|
||||
GET https://api.crossbeam.com/v1/populations
|
||||
Authorization: Bearer {api_key}
|
||||
```
|
||||
|
||||
### List Overlaps
|
||||
|
||||
```bash
|
||||
GET https://api.crossbeam.com/v1/overlaps?partner_id={partner_id}&population_id={population_id}
|
||||
Authorization: Bearer {api_key}
|
||||
```
|
||||
|
||||
### Get Overlap Details
|
||||
|
||||
```bash
|
||||
GET https://api.crossbeam.com/v1/overlaps/{id}
|
||||
Authorization: Bearer {api_key}
|
||||
```
|
||||
|
||||
### Search Accounts
|
||||
|
||||
```bash
|
||||
GET https://api.crossbeam.com/v1/accounts/search?domain={domain}
|
||||
Authorization: Bearer {api_key}
|
||||
```
|
||||
|
||||
### List Reports
|
||||
|
||||
```bash
|
||||
GET https://api.crossbeam.com/v1/reports
|
||||
Authorization: Bearer {api_key}
|
||||
```
|
||||
|
||||
### List Collaboration Threads
|
||||
|
||||
```bash
|
||||
GET https://api.crossbeam.com/v1/threads
|
||||
Authorization: Bearer {api_key}
|
||||
```
|
||||
|
||||
## Key Metrics
|
||||
|
||||
### Partner Data
|
||||
- `id` - Partner ID
|
||||
- `name` - Partner company name
|
||||
- `status` - Partnership status (active, pending, etc.)
|
||||
- `created_at` - When the partnership was established
|
||||
- `populations_shared` - Number of shared populations
|
||||
|
||||
### Population Data
|
||||
- `id` - Population ID
|
||||
- `name` - Population name (e.g., "Customers", "Open Opportunities")
|
||||
- `record_count` - Number of records in population
|
||||
- `partner_visibility` - What partners can see
|
||||
|
||||
### Overlap Data
|
||||
- `id` - Overlap ID
|
||||
- `partner_id` - Partner involved
|
||||
- `population_id` - Population matched
|
||||
- `account_name` - Overlapping account name
|
||||
- `overlap_type` - Type of overlap (customer, prospect, etc.)
|
||||
- `match_confidence` - Match confidence score
|
||||
|
||||
### Report Data
|
||||
- `id` - Report ID
|
||||
- `name` - Report name
|
||||
- `type` - Report type
|
||||
- `created_at` - Creation date
|
||||
- `results` - Report results data
|
||||
|
||||
## Parameters
|
||||
|
||||
### Overlaps List
|
||||
- `partner_id` - Filter by specific partner
|
||||
- `population_id` - Filter by specific population
|
||||
|
||||
### Accounts Search
|
||||
- `domain` - Company domain to search for
|
||||
|
||||
## When to Use
|
||||
|
||||
- Identifying co-sell opportunities with channel partners
|
||||
- Finding overlapping customers and prospects across partner ecosystems
|
||||
- Building partner-sourced pipeline by matching accounts
|
||||
- Tracking partner influence on deals
|
||||
- Creating account mapping reports for partner meetings
|
||||
- Prioritizing which partners to engage based on overlap data
|
||||
|
||||
## Rate Limits
|
||||
|
||||
- Rate limits vary by plan
|
||||
- Standard: 100 requests/minute
|
||||
- Pagination supported on list endpoints
|
||||
|
||||
## Relevant Skills
|
||||
|
||||
- revops
|
||||
- sales-enablement
|
||||
- referral-program
|
||||
- competitor-alternatives
|
||||
@@ -0,0 +1,172 @@
|
||||
# Outreach
|
||||
|
||||
Sales engagement platform for managing prospects, sequences, and outbound campaigns at scale.
|
||||
|
||||
## Capabilities
|
||||
|
||||
| Integration | Available | Notes |
|
||||
|-------------|-----------|-------|
|
||||
| API | ✓ | Prospects, Sequences, Mailings, Accounts, Tasks |
|
||||
| MCP | ✓ | [Claude connector](https://claude.com/connectors/outreach) |
|
||||
| CLI | ✓ | [outreach.js](../clis/outreach.js) |
|
||||
| SDK | - | REST API only (JSON:API format) |
|
||||
|
||||
## Authentication
|
||||
|
||||
- **Type**: OAuth2 Bearer Token
|
||||
- **Header**: `Authorization: Bearer {access_token}`
|
||||
- **Content-Type**: `application/vnd.api+json`
|
||||
- **Get token**: Settings > API at https://app.outreach.io or via OAuth2 flow
|
||||
|
||||
## Common Agent Operations
|
||||
|
||||
### List Prospects
|
||||
|
||||
```bash
|
||||
curl -s https://api.outreach.io/api/v2/prospects \
|
||||
-H "Authorization: Bearer $OUTREACH_ACCESS_TOKEN" \
|
||||
-H "Content-Type: application/vnd.api+json"
|
||||
```
|
||||
|
||||
### Get a Prospect
|
||||
|
||||
```bash
|
||||
curl -s https://api.outreach.io/api/v2/prospects/42 \
|
||||
-H "Authorization: Bearer $OUTREACH_ACCESS_TOKEN" \
|
||||
-H "Content-Type: application/vnd.api+json"
|
||||
```
|
||||
|
||||
### Create a Prospect
|
||||
|
||||
```bash
|
||||
curl -s -X POST https://api.outreach.io/api/v2/prospects \
|
||||
-H "Authorization: Bearer $OUTREACH_ACCESS_TOKEN" \
|
||||
-H "Content-Type: application/vnd.api+json" \
|
||||
-d '{
|
||||
"data": {
|
||||
"type": "prospect",
|
||||
"attributes": {
|
||||
"emails": ["jane@example.com"],
|
||||
"firstName": "Jane",
|
||||
"lastName": "Doe"
|
||||
}
|
||||
}
|
||||
}'
|
||||
```
|
||||
|
||||
### List Sequences
|
||||
|
||||
```bash
|
||||
curl -s https://api.outreach.io/api/v2/sequences \
|
||||
-H "Authorization: Bearer $OUTREACH_ACCESS_TOKEN" \
|
||||
-H "Content-Type: application/vnd.api+json"
|
||||
```
|
||||
|
||||
### Add Prospect to Sequence
|
||||
|
||||
```bash
|
||||
curl -s -X POST https://api.outreach.io/api/v2/sequenceStates \
|
||||
-H "Authorization: Bearer $OUTREACH_ACCESS_TOKEN" \
|
||||
-H "Content-Type: application/vnd.api+json" \
|
||||
-d '{
|
||||
"data": {
|
||||
"type": "sequenceState",
|
||||
"relationships": {
|
||||
"prospect": { "data": { "type": "prospect", "id": 42 } },
|
||||
"sequence": { "data": { "type": "sequence", "id": 7 } }
|
||||
}
|
||||
}
|
||||
}'
|
||||
```
|
||||
|
||||
### List Mailings for a Sequence
|
||||
|
||||
```bash
|
||||
curl -s "https://api.outreach.io/api/v2/mailings?filter[sequence][id]=7" \
|
||||
-H "Authorization: Bearer $OUTREACH_ACCESS_TOKEN" \
|
||||
-H "Content-Type: application/vnd.api+json"
|
||||
```
|
||||
|
||||
### List Accounts
|
||||
|
||||
```bash
|
||||
curl -s https://api.outreach.io/api/v2/accounts \
|
||||
-H "Authorization: Bearer $OUTREACH_ACCESS_TOKEN" \
|
||||
-H "Content-Type: application/vnd.api+json"
|
||||
```
|
||||
|
||||
### List Tasks
|
||||
|
||||
```bash
|
||||
curl -s "https://api.outreach.io/api/v2/tasks?filter[status]=incomplete" \
|
||||
-H "Authorization: Bearer $OUTREACH_ACCESS_TOKEN" \
|
||||
-H "Content-Type: application/vnd.api+json"
|
||||
```
|
||||
|
||||
## Key Metrics
|
||||
|
||||
### Prospect Data
|
||||
- `firstName`, `lastName` - Name
|
||||
- `emails` - Email addresses
|
||||
- `title` - Job title
|
||||
- `company` - Company name
|
||||
- `tags` - Prospect tags
|
||||
- `engagedAt` - Last engagement timestamp
|
||||
|
||||
### Sequence Data
|
||||
- `name` - Sequence name
|
||||
- `enabled` - Whether sequence is active
|
||||
- `sequenceType` - Type (e.g., interval, date-based)
|
||||
- `stepCount` - Number of steps
|
||||
- `openCount`, `clickCount`, `replyCount` - Engagement metrics
|
||||
|
||||
### Mailing Data
|
||||
- `mailingType` - Type of mailing
|
||||
- `state` - Delivery state
|
||||
- `openCount`, `clickCount` - Engagement
|
||||
- `deliveredAt`, `openedAt`, `clickedAt` - Timestamps
|
||||
|
||||
## Parameters
|
||||
|
||||
### Prospects
|
||||
- `page[number]` - Page number (default: 1)
|
||||
- `page[size]` - Results per page (default: 25, max: 1000)
|
||||
- `filter[emails]` - Filter by email
|
||||
- `filter[firstName]` - Filter by first name
|
||||
- `filter[lastName]` - Filter by last name
|
||||
- `sort` - Sort field (e.g., `createdAt`, `-updatedAt`)
|
||||
|
||||
### Sequences
|
||||
- `filter[name]` - Filter by sequence name
|
||||
- `filter[enabled]` - Filter by active status
|
||||
|
||||
### Mailings
|
||||
- `filter[sequence][id]` - Filter by sequence ID
|
||||
- `filter[prospect][id]` - Filter by prospect ID
|
||||
|
||||
### Tasks
|
||||
- `filter[status]` - Filter by status (e.g., `incomplete`, `complete`)
|
||||
- `filter[taskType]` - Filter by type (e.g., `call`, `email`, `action_item`)
|
||||
|
||||
## When to Use
|
||||
|
||||
- Managing outbound sales sequences and cadences
|
||||
- Adding prospects to automated email sequences
|
||||
- Tracking prospect engagement across touchpoints
|
||||
- Managing sales tasks and follow-ups
|
||||
- Coordinating multi-channel outreach campaigns
|
||||
- Monitoring sequence performance and reply rates
|
||||
|
||||
## Rate Limits
|
||||
|
||||
- 10,000 requests per hour per user
|
||||
- Burst limit: 100 requests per 10 seconds
|
||||
- Rate limit headers returned: `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset`
|
||||
- 429 responses when limits exceeded
|
||||
|
||||
## Relevant Skills
|
||||
|
||||
- cold-email
|
||||
- revops
|
||||
- sales-enablement
|
||||
- email-sequence
|
||||
@@ -0,0 +1,208 @@
|
||||
# Pendo
|
||||
|
||||
Product analytics and in-app guidance platform for tracking user behavior, measuring feature adoption, and delivering targeted in-app messages.
|
||||
|
||||
## Capabilities
|
||||
|
||||
| Integration | Available | Notes |
|
||||
|-------------|-----------|-------|
|
||||
| API | ✓ | Features, Pages, Guides, Visitors, Accounts, Reports, Metadata |
|
||||
| MCP | - | Not available |
|
||||
| CLI | ✓ | [pendo.js](../clis/pendo.js) |
|
||||
| SDK | - | REST API only |
|
||||
|
||||
## Authentication
|
||||
|
||||
- **Type**: Integration Key
|
||||
- **Header**: `x-pendo-integration-key: {key}`
|
||||
- **Get key**: Settings > Integrations at https://app.pendo.io
|
||||
|
||||
## Common Agent Operations
|
||||
|
||||
### List Features
|
||||
|
||||
```bash
|
||||
GET https://app.pendo.io/api/v1/feature
|
||||
```
|
||||
|
||||
### Get Feature Details
|
||||
|
||||
```bash
|
||||
GET https://app.pendo.io/api/v1/feature/{featureId}
|
||||
```
|
||||
|
||||
### List Pages
|
||||
|
||||
```bash
|
||||
GET https://app.pendo.io/api/v1/page
|
||||
```
|
||||
|
||||
### Get Page Details
|
||||
|
||||
```bash
|
||||
GET https://app.pendo.io/api/v1/page/{pageId}
|
||||
```
|
||||
|
||||
### List Guides
|
||||
|
||||
```bash
|
||||
GET https://app.pendo.io/api/v1/guide?state=published
|
||||
```
|
||||
|
||||
### Get Guide Details
|
||||
|
||||
```bash
|
||||
GET https://app.pendo.io/api/v1/guide/{guideId}
|
||||
```
|
||||
|
||||
### Get Visitor Data
|
||||
|
||||
```bash
|
||||
GET https://app.pendo.io/api/v1/visitor/{visitorId}
|
||||
```
|
||||
|
||||
### Search Visitors
|
||||
|
||||
```bash
|
||||
POST https://app.pendo.io/api/v1/aggregation
|
||||
|
||||
{
|
||||
"response": { "mimeType": "application/json" },
|
||||
"request": {
|
||||
"pipeline": [
|
||||
{ "source": { "visitors": null } },
|
||||
{ "filter": "lastVisitedAt > 1700000000000" }
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Get Account Data
|
||||
|
||||
```bash
|
||||
GET https://app.pendo.io/api/v1/account/{accountId}
|
||||
```
|
||||
|
||||
### Search Accounts
|
||||
|
||||
```bash
|
||||
POST https://app.pendo.io/api/v1/aggregation
|
||||
|
||||
{
|
||||
"response": { "mimeType": "application/json" },
|
||||
"request": {
|
||||
"pipeline": [
|
||||
{ "source": { "accounts": null } },
|
||||
{ "filter": "metadata.auto.lastupdated > 1700000000000" }
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Run Funnel Report
|
||||
|
||||
```bash
|
||||
POST https://app.pendo.io/api/v1/aggregation
|
||||
|
||||
{
|
||||
"response": { "mimeType": "application/json" },
|
||||
"request": {
|
||||
"pipeline": [
|
||||
{ "source": { "visitors": null, "timeSeries": { "period": "dayRange", "first": 1700000000000, "last": 1700600000000 } } },
|
||||
{ "identified": "visitorId" },
|
||||
{ "filter": "pageId == \"page-id-1\"" },
|
||||
{ "filter": "pageId == \"page-id-2\"" }
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### List Metadata Fields
|
||||
|
||||
```bash
|
||||
GET https://app.pendo.io/api/v1/metadata/schema/visitor
|
||||
GET https://app.pendo.io/api/v1/metadata/schema/account
|
||||
GET https://app.pendo.io/api/v1/metadata/schema/parentAccount
|
||||
```
|
||||
|
||||
## Key Metrics
|
||||
|
||||
### Feature Data
|
||||
- `id` - Feature ID
|
||||
- `name` - Feature name
|
||||
- `kind` - Feature type
|
||||
- `elementPath` - CSS selector for the tracked element
|
||||
- `pageId` - Associated page ID
|
||||
- `numEvents` - Event count
|
||||
- `numVisitors` - Unique visitor count
|
||||
|
||||
### Page Data
|
||||
- `id` - Page ID
|
||||
- `name` - Page name
|
||||
- `rules` - URL matching rules
|
||||
- `numEvents` - Pageview count
|
||||
- `numVisitors` - Unique visitor count
|
||||
|
||||
### Guide Data
|
||||
- `id` - Guide ID
|
||||
- `name` - Guide name
|
||||
- `state` - Guide state (draft, staged, public, disabled)
|
||||
- `launchMethod` - How the guide is triggered
|
||||
- `steps` - Guide step definitions
|
||||
- `numSteps` - Number of steps
|
||||
- `numViews` - Total views
|
||||
- `numVisitors` - Unique visitors who saw the guide
|
||||
|
||||
### Visitor Data
|
||||
- `visitorId` - Unique visitor identifier
|
||||
- `lastVisitedAt` - Last visit timestamp
|
||||
- `firstVisit` - First visit timestamp
|
||||
- `numEvents` - Total event count
|
||||
- `metadata` - Custom visitor metadata
|
||||
|
||||
### Account Data
|
||||
- `accountId` - Unique account identifier
|
||||
- `lastVisitedAt` - Last visit from any account member
|
||||
- `numVisitors` - Number of visitors in the account
|
||||
- `metadata` - Custom account metadata
|
||||
|
||||
## Parameters
|
||||
|
||||
### Guide Filtering
|
||||
- `state` - Filter by state: draft, staged, public, disabled
|
||||
|
||||
### Aggregation Queries
|
||||
- `source` - Data source: visitors, accounts, features, pages, guides
|
||||
- `filter` - Expression-based filtering
|
||||
- `sort` - Sort results
|
||||
- `limit` - Max results to return
|
||||
- `timeSeries` - Time range with period, first, last
|
||||
|
||||
### Metadata Kinds
|
||||
- `visitor` - Visitor metadata schema
|
||||
- `account` - Account metadata schema
|
||||
- `parentAccount` - Parent account metadata schema
|
||||
|
||||
## When to Use
|
||||
|
||||
- Tracking feature adoption and usage patterns
|
||||
- Building and managing in-app onboarding guides
|
||||
- Analyzing user behavior across pages and features
|
||||
- Segmenting users by engagement level
|
||||
- Running funnel analysis on user journeys
|
||||
- Identifying at-risk accounts based on usage decline
|
||||
- A/B testing in-app messages and tooltips
|
||||
|
||||
## Rate Limits
|
||||
|
||||
- Rate limits vary by plan
|
||||
- Standard: 500 requests per minute
|
||||
- Aggregation queries: may take longer for large datasets
|
||||
- Use pagination for large result sets
|
||||
|
||||
## Relevant Skills
|
||||
|
||||
- analytics-tracking
|
||||
- onboarding-cro
|
||||
- churn-prevention
|
||||
- ab-test-setup
|
||||
@@ -0,0 +1,150 @@
|
||||
# Similarweb
|
||||
|
||||
Competitive traffic intelligence platform providing website analytics, traffic sources, keyword data, and competitor insights.
|
||||
|
||||
## Capabilities
|
||||
|
||||
| Integration | Available | Notes |
|
||||
|-------------|-----------|-------|
|
||||
| API | ✓ | Traffic, Search, Referrals, Competitors, Geography |
|
||||
| MCP | - | Not available |
|
||||
| CLI | ✓ | [similarweb.js](../clis/similarweb.js) |
|
||||
| SDK | - | REST API only |
|
||||
|
||||
## Authentication
|
||||
|
||||
- **Type**: API Key
|
||||
- **Query param**: `?api_key={key}`
|
||||
- **Get key**: Account Settings > API at https://account.similarweb.com
|
||||
|
||||
## Common Agent Operations
|
||||
|
||||
### Total Visits
|
||||
|
||||
```bash
|
||||
GET https://api.similarweb.com/v1/website/example.com/total-traffic-and-engagement/visits?api_key={key}&start_date=2024-01&end_date=2024-03&country=us&granularity=monthly
|
||||
```
|
||||
|
||||
### Pages Per Visit
|
||||
|
||||
```bash
|
||||
GET https://api.similarweb.com/v1/website/example.com/total-traffic-and-engagement/pages-per-visit?api_key={key}&start_date=2024-01&end_date=2024-03
|
||||
```
|
||||
|
||||
### Average Visit Duration
|
||||
|
||||
```bash
|
||||
GET https://api.similarweb.com/v1/website/example.com/total-traffic-and-engagement/average-visit-duration?api_key={key}&start_date=2024-01&end_date=2024-03
|
||||
```
|
||||
|
||||
### Bounce Rate
|
||||
|
||||
```bash
|
||||
GET https://api.similarweb.com/v1/website/example.com/total-traffic-and-engagement/bounce-rate?api_key={key}&start_date=2024-01&end_date=2024-03
|
||||
```
|
||||
|
||||
### Traffic Sources Breakdown
|
||||
|
||||
```bash
|
||||
GET https://api.similarweb.com/v1/website/example.com/traffic-sources/overview?api_key={key}&start_date=2024-01&end_date=2024-03
|
||||
```
|
||||
|
||||
### Top Referral Sites
|
||||
|
||||
```bash
|
||||
GET https://api.similarweb.com/v1/website/example.com/traffic-sources/referrals?api_key={key}&start_date=2024-01&end_date=2024-03
|
||||
```
|
||||
|
||||
### Organic Keywords
|
||||
|
||||
```bash
|
||||
GET https://api.similarweb.com/v1/website/example.com/search/organic-search-keywords?api_key={key}&start_date=2024-01&end_date=2024-03
|
||||
```
|
||||
|
||||
### Paid Keywords
|
||||
|
||||
```bash
|
||||
GET https://api.similarweb.com/v1/website/example.com/search/paid-search-keywords?api_key={key}&start_date=2024-01&end_date=2024-03
|
||||
```
|
||||
|
||||
### Similar Sites / Competitors
|
||||
|
||||
```bash
|
||||
GET https://api.similarweb.com/v1/website/example.com/similar-sites/similarsites?api_key={key}
|
||||
```
|
||||
|
||||
### Category Ranking
|
||||
|
||||
```bash
|
||||
GET https://api.similarweb.com/v1/website/example.com/category-rank/category-rank?api_key={key}
|
||||
```
|
||||
|
||||
### Traffic by Country
|
||||
|
||||
```bash
|
||||
GET https://api.similarweb.com/v1/website/example.com/geo/traffic-by-country?api_key={key}&start_date=2024-01&end_date=2024-03
|
||||
```
|
||||
|
||||
## Key Metrics
|
||||
|
||||
### Traffic & Engagement
|
||||
- `visits` - Total visits for the period
|
||||
- `pages_per_visit` - Average pages viewed per visit
|
||||
- `average_visit_duration` - Average session duration in seconds
|
||||
- `bounce_rate` - Percentage of single-page visits
|
||||
|
||||
### Traffic Sources
|
||||
- `search` - Organic + paid search percentage
|
||||
- `social` - Social media traffic percentage
|
||||
- `direct` - Direct traffic percentage
|
||||
- `referrals` - Referral traffic percentage
|
||||
- `mail` - Email traffic percentage
|
||||
- `display_ads` - Display advertising percentage
|
||||
|
||||
### Search Keywords
|
||||
- `search_term` - Keyword text
|
||||
- `share` - Traffic share percentage
|
||||
- `volume` - Search volume
|
||||
- `cpc` - Cost per click
|
||||
- `position` - Average ranking position
|
||||
|
||||
### Geography
|
||||
- `country` - Country code
|
||||
- `share` - Traffic share from that country
|
||||
|
||||
## Parameters
|
||||
|
||||
### Common Parameters
|
||||
- `start_date` - Start month (YYYY-MM format)
|
||||
- `end_date` - End month (YYYY-MM format)
|
||||
- `country` - Two-letter country code (e.g., us, gb, de)
|
||||
- `granularity` - Data granularity: monthly, weekly, daily
|
||||
|
||||
### Search Parameters
|
||||
- `limit` - Number of keywords to return
|
||||
- `country` - Filter by country
|
||||
|
||||
## When to Use
|
||||
|
||||
- Analyzing competitor website traffic and engagement metrics
|
||||
- Benchmarking your site against competitors
|
||||
- Identifying top traffic sources for any website
|
||||
- Discovering competitor organic and paid keywords
|
||||
- Finding similar sites and competitive landscape
|
||||
- Understanding geographic traffic distribution
|
||||
- Auditing SEO performance relative to competitors
|
||||
- Researching market share by traffic volume
|
||||
|
||||
## Rate Limits
|
||||
|
||||
- Rate limits vary by plan tier
|
||||
- Standard: 10 requests/second
|
||||
- Data availability depends on plan (3 months to 36 months historical)
|
||||
- Some endpoints require Premium or Enterprise plans
|
||||
|
||||
## Relevant Skills
|
||||
|
||||
- seo-audit
|
||||
- competitor-alternatives
|
||||
- paid-ads
|
||||
- content-strategy
|
||||
@@ -0,0 +1,145 @@
|
||||
# Supermetrics
|
||||
|
||||
Marketing data pipeline that connects 200+ marketing platforms. Pulls data from ad platforms, analytics, social, SEO, email, and more into a single query interface.
|
||||
|
||||
## Capabilities
|
||||
|
||||
| Integration | Available | Notes |
|
||||
|-------------|-----------|-------|
|
||||
| API | ✓ | Query any connected data source, manage accounts |
|
||||
| MCP | ✓ | [Claude connector](https://claude.com/connectors/supermetrics) |
|
||||
| CLI | ✓ | [supermetrics.js](../clis/supermetrics.js) |
|
||||
| SDK | - | REST API only |
|
||||
|
||||
## Authentication
|
||||
|
||||
- **Type**: API Key
|
||||
- **Query param**: `api_key={api_key}` or **Header**: `x-api-key: {api_key}`
|
||||
- **Get key**: Supermetrics Hub > API settings at https://hub.supermetrics.com
|
||||
|
||||
## Common Agent Operations
|
||||
|
||||
### Query a Data Source
|
||||
|
||||
```bash
|
||||
POST https://api.supermetrics.com/enterprise/v2/query
|
||||
|
||||
{
|
||||
"ds_id": "GA4",
|
||||
"ds_accounts": "123456789",
|
||||
"date_range_type": "last_28_days",
|
||||
"fields": [
|
||||
{ "name": "sessions" },
|
||||
{ "name": "pageviews" },
|
||||
{ "name": "date" }
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
### Query with Filters
|
||||
|
||||
```bash
|
||||
POST https://api.supermetrics.com/enterprise/v2/query
|
||||
|
||||
{
|
||||
"ds_id": "AW",
|
||||
"ds_accounts": "123-456-7890",
|
||||
"date_range_type": "last_month",
|
||||
"fields": [
|
||||
{ "name": "campaign_name" },
|
||||
{ "name": "clicks" },
|
||||
{ "name": "impressions" },
|
||||
{ "name": "cost" }
|
||||
],
|
||||
"max_rows": 100
|
||||
}
|
||||
```
|
||||
|
||||
### List Available Data Sources
|
||||
|
||||
```bash
|
||||
GET https://api.supermetrics.com/enterprise/v2/datasources
|
||||
```
|
||||
|
||||
### List Connected Accounts
|
||||
|
||||
```bash
|
||||
GET https://api.supermetrics.com/enterprise/v2/datasources/accounts?ds_id=GA4
|
||||
```
|
||||
|
||||
### List Teams
|
||||
|
||||
```bash
|
||||
GET https://api.supermetrics.com/enterprise/v2/teams
|
||||
```
|
||||
|
||||
### List Users
|
||||
|
||||
```bash
|
||||
GET https://api.supermetrics.com/enterprise/v2/users
|
||||
```
|
||||
|
||||
## Key Metrics
|
||||
|
||||
### Data Source IDs
|
||||
- `GA4` - Google Analytics 4
|
||||
- `GA4_PAID` - Google Analytics (paid)
|
||||
- `AW` - Google Ads
|
||||
- `FB` - Facebook Ads
|
||||
- `LI` - LinkedIn Ads
|
||||
- `TW_ADS` - Twitter Ads
|
||||
- `IG_IA` - Instagram
|
||||
- `FB_IA` - Facebook Pages
|
||||
- `GSC` - Google Search Console
|
||||
- `SE` - Semrush
|
||||
- `MC` - Mailchimp
|
||||
- `HubSpot` - HubSpot
|
||||
|
||||
### Date Range Values
|
||||
- `last_28_days` - Last 28 days
|
||||
- `last_month` - Previous calendar month
|
||||
- `this_month` - Current month to date
|
||||
- `custom` - Custom range (requires `start_date` and `end_date`)
|
||||
|
||||
## Parameters
|
||||
|
||||
### Query
|
||||
- `ds_id` - Data source identifier (required)
|
||||
- `ds_accounts` - Account ID for the data source (required)
|
||||
- `date_range_type` - Date range preset or "custom" (required)
|
||||
- `fields` - Array of field objects with `name` property (required)
|
||||
- `filter` - Filter expression for narrowing results
|
||||
- `max_rows` - Maximum number of rows to return
|
||||
- `start_date` - Start date for custom range (YYYY-MM-DD)
|
||||
- `end_date` - End date for custom range (YYYY-MM-DD)
|
||||
|
||||
### Common Fields by Source
|
||||
- **GA4**: `sessions`, `pageviews`, `users`, `bounce_rate`, `date`, `source`, `medium`, `page_path`
|
||||
- **Google Ads**: `campaign_name`, `clicks`, `impressions`, `cost`, `conversions`, `ctr`, `cpc`
|
||||
- **Facebook Ads**: `campaign_name`, `impressions`, `clicks`, `spend`, `reach`, `cpm`, `cpc`
|
||||
- **LinkedIn Ads**: `campaign_name`, `impressions`, `clicks`, `cost`, `conversions`
|
||||
- **GSC**: `query`, `clicks`, `impressions`, `ctr`, `position`, `page`
|
||||
|
||||
## When to Use
|
||||
|
||||
- Pulling cross-platform marketing data into a single report
|
||||
- Comparing performance across ad platforms (Google, Meta, LinkedIn, TikTok)
|
||||
- Aggregating analytics data from multiple sources
|
||||
- Automating marketing reporting workflows
|
||||
- Building unified dashboards across marketing channels
|
||||
- Extracting SEO data alongside paid media metrics
|
||||
|
||||
## Rate Limits
|
||||
|
||||
- Rate limits vary by plan
|
||||
- Enterprise API: typically 100 requests/minute
|
||||
- Query results may be paginated for large datasets
|
||||
- Recommended: use `max_rows` to control response size
|
||||
|
||||
## Relevant Skills
|
||||
|
||||
- analytics-tracking
|
||||
- paid-ads
|
||||
- seo-audit
|
||||
- content-strategy
|
||||
- social-content
|
||||
@@ -0,0 +1,191 @@
|
||||
# ZoomInfo
|
||||
|
||||
B2B contact database and intent data platform with 100M+ business contacts and company intelligence for sales and marketing teams.
|
||||
|
||||
## Capabilities
|
||||
|
||||
| Integration | Available | Notes |
|
||||
|-------------|-----------|-------|
|
||||
| API | ✓ | Contact Search, Company Search, Enrichment, Intent Data, Scoops |
|
||||
| MCP | ✓ | [Claude connector](https://claude.com/connectors/zoominfo) |
|
||||
| CLI | ✓ | [zoominfo.js](../clis/zoominfo.js) |
|
||||
| SDK | - | REST API only |
|
||||
|
||||
## Authentication
|
||||
|
||||
- **Type**: JWT Token (Bearer)
|
||||
- **Flow**: POST `/authenticate` with username + password, receive JWT token
|
||||
- **Header**: `Authorization: Bearer {jwt_token}`
|
||||
- **Env vars**: `ZOOMINFO_USERNAME` + `ZOOMINFO_PRIVATE_KEY` or `ZOOMINFO_ACCESS_TOKEN`
|
||||
- **Get credentials**: Contact ZoomInfo sales or admin portal at https://app.zoominfo.com
|
||||
|
||||
## Common Agent Operations
|
||||
|
||||
### Authenticate
|
||||
|
||||
```bash
|
||||
POST https://api.zoominfo.com/authenticate
|
||||
|
||||
{
|
||||
"username": "user@company.com",
|
||||
"password": "private-key-here"
|
||||
}
|
||||
```
|
||||
|
||||
### Contact Search
|
||||
|
||||
```bash
|
||||
POST https://api.zoominfo.com/search/contact
|
||||
|
||||
{
|
||||
"jobTitle": ["VP Marketing"],
|
||||
"companyName": ["Acme Corp"],
|
||||
"managementLevel": ["VP"],
|
||||
"rpp": 25,
|
||||
"page": 1
|
||||
}
|
||||
```
|
||||
|
||||
### Contact Enrichment
|
||||
|
||||
```bash
|
||||
POST https://api.zoominfo.com/enrich/contact
|
||||
|
||||
{
|
||||
"matchEmail": ["jane@acme.com"]
|
||||
}
|
||||
```
|
||||
|
||||
### Company Search
|
||||
|
||||
```bash
|
||||
POST https://api.zoominfo.com/search/company
|
||||
|
||||
{
|
||||
"companyName": ["Acme"],
|
||||
"industry": ["Software"],
|
||||
"employeeCountMin": 50,
|
||||
"revenueMin": 10000000,
|
||||
"rpp": 25,
|
||||
"page": 1
|
||||
}
|
||||
```
|
||||
|
||||
### Company Enrichment
|
||||
|
||||
```bash
|
||||
POST https://api.zoominfo.com/enrich/company
|
||||
|
||||
{
|
||||
"matchCompanyWebsite": ["acme.com"]
|
||||
}
|
||||
```
|
||||
|
||||
### Intent Data Lookup
|
||||
|
||||
```bash
|
||||
POST https://api.zoominfo.com/lookup/intent
|
||||
|
||||
{
|
||||
"topicId": ["marketing-automation"],
|
||||
"companyId": ["123456"]
|
||||
}
|
||||
```
|
||||
|
||||
### Scoops Lookup
|
||||
|
||||
```bash
|
||||
POST https://api.zoominfo.com/lookup/scoops
|
||||
|
||||
{
|
||||
"companyId": ["123456"],
|
||||
"rpp": 25,
|
||||
"page": 1
|
||||
}
|
||||
```
|
||||
|
||||
## Key Metrics
|
||||
|
||||
### Contact Data
|
||||
- `firstName`, `lastName` - Name
|
||||
- `jobTitle` - Job title
|
||||
- `email` - Verified email
|
||||
- `phone` - Direct phone
|
||||
- `linkedinUrl` - LinkedIn profile
|
||||
- `companyName` - Company name
|
||||
- `managementLevel` - Seniority level
|
||||
- `department` - Department
|
||||
|
||||
### Company Data
|
||||
- `companyName` - Company name
|
||||
- `website` - Website URL
|
||||
- `employeeCount` - Employee count
|
||||
- `industry` - Industry
|
||||
- `revenue` - Annual revenue
|
||||
- `techStack` - Technologies used
|
||||
- `fundingAmount` - Total funding
|
||||
- `companyCity`, `companyState`, `companyCountry` - Location
|
||||
|
||||
### Intent Data
|
||||
- `topicName` - Intent topic
|
||||
- `signalScore` - Signal strength
|
||||
- `audienceStrength` - Audience engagement level
|
||||
- `firstSeenDate`, `lastSeenDate` - Signal timeframe
|
||||
|
||||
## Parameters
|
||||
|
||||
### Contact Search
|
||||
- `jobTitle` - Array of job titles
|
||||
- `companyName` - Array of company names
|
||||
- `managementLevel` - Array: C-Level, VP, Director, Manager, Staff
|
||||
- `department` - Array: Marketing, Sales, Engineering, Finance, etc.
|
||||
- `personLocationCity` - Array of cities
|
||||
- `personLocationState` - Array of states
|
||||
- `personLocationCountry` - Array of countries
|
||||
- `rpp` - Results per page (default: 25, max: 100)
|
||||
- `page` - Page number (default: 1)
|
||||
|
||||
### Contact Enrichment
|
||||
- `matchEmail` - Array of email addresses
|
||||
- `personId` - Array of ZoomInfo person IDs
|
||||
- `matchFirstName` + `matchLastName` + `matchCompanyName` - Alternative lookup
|
||||
|
||||
### Company Search
|
||||
- `companyName` - Array of company names
|
||||
- `industry` - Array of industries
|
||||
- `employeeCountMin` / `employeeCountMax` - Employee count range
|
||||
- `revenueMin` / `revenueMax` - Revenue range
|
||||
- `companyLocationCity` - Array of cities
|
||||
- `rpp` - Results per page
|
||||
- `page` - Page number
|
||||
|
||||
### Company Enrichment
|
||||
- `matchCompanyWebsite` - Array of domains
|
||||
- `companyId` - Array of ZoomInfo company IDs
|
||||
|
||||
### Intent Data
|
||||
- `topicId` - Array of intent topic IDs
|
||||
- `companyId` - Array of company IDs
|
||||
|
||||
## When to Use
|
||||
|
||||
- Identifying in-market accounts with intent signals
|
||||
- Building targeted contact lists by role, seniority, and company
|
||||
- Enriching leads with verified contact data and firmographics
|
||||
- Finding decision-makers at target accounts for ABM
|
||||
- Tracking company news and leadership changes via scoops
|
||||
- Prioritizing outreach based on buyer intent signals
|
||||
|
||||
## Rate Limits
|
||||
|
||||
- Rate limits vary by plan and endpoint
|
||||
- Standard: ~200 requests/minute
|
||||
- Bulk endpoints: batched requests recommended
|
||||
- Authentication tokens expire after ~12 hours
|
||||
|
||||
## Relevant Skills
|
||||
|
||||
- cold-email
|
||||
- revops
|
||||
- sales-enablement
|
||||
- competitor-alternatives
|
||||
Reference in New Issue
Block a user