### Development Setup (Bash)

Source: https://github.com/bcharleson/trigify-cli/blob/main/README.md

Basic commands to clone the Trigify CLI repository and install its dependencies using npm. This is the starting point for contributing to the project.

```bash
git clone https://github.com/bcharleson/trigify-cli
cd trigify-cli
npm install
```

--------------------------------

### Install Trigify CLI

Source: https://github.com/bcharleson/trigify-cli/blob/main/README.md

Instructions for installing the Trigify CLI globally using npm or running it directly via npx.

```bash
# Install globally
npm install -g trigify-cli

# Or run without installing
npx trigify-cli --help
```

--------------------------------

### Trigify CLI Integration Pipeline Example (Trigify → Clay → Instantly)

Source: https://github.com/bcharleson/trigify-cli/blob/main/AGENTS.md

An example pipeline demonstrating how to integrate Trigify CLI with Clay for contact enrichment and Instantly for sequencing. This showcases a common workflow for sales and marketing automation.

```bash
# 1. Get ICP-matched people from Trigify
trigify social mapping \
  --keywords "outbound sales,cold email" \
  --seniority "VP,Director" \
  --company-size "51-200" \
  --limit 50 \
  --fields "name,headline,profile_url,company,urn" > prospects.json

# 2. Pass profile_url to Clay for email enrichment
# 3. Pass enriched contacts to Instantly for sequencing
```

--------------------------------

### Configure Claude Desktop using NPX for Trigify MCP Server (JSON)

Source: https://github.com/bcharleson/trigify-cli/blob/main/README.md

Alternative JSON configuration for Claude Desktop using `npx` to run the Trigify MCP server without a local installation. This is useful for environments where global installation is not desired.

```json
{
  "mcpServers": {
    "trigify": {
      "command": "npx",
      "args": ["trigify-cli", "mcp"],
      "env": {
        "TRIGIFY_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

--------------------------------

### Start Trigify MCP Server (Bash)

Source: https://github.com/bcharleson/trigify-cli/blob/main/README.md

Command to start the Trigify MCP server, making all CLI commands available as tools for AI agents. This is a single command to initiate the server.

```bash
trigify mcp
```

--------------------------------

### Execute Social Listening and Prospecting Commands

Source: https://github.com/bcharleson/trigify-cli/blob/main/README.md

Examples of using the CLI to create searches, retrieve engagement data, and perform ICP-based prospecting.

```bash
# Monitor brand mentions
trigify searches create --name "Brand: MyCompany" --keywords "MyCompany,MyCompany.io" --platforms "linkedin,twitter,reddit"

# Find people engaging with pain-point keywords
trigify topics create --name "Intent: outbound pain" --keywords "cold email not working,outbound ROI,SDR quota" --exclude "job,hiring"

# Prospect with ICP filters
trigify social mapping --keywords "outbound sales,cold email,SDR" --seniority "VP,Director" --company-size "51-200" --industry "SaaS" --limit 50 --pretty

# Profile research
trigify profiles posts --url "https://www.linkedin.com/in/johndoe" --limit 10 --pretty
```

--------------------------------

### CLI Output Formatting

Source: https://github.com/bcharleson/trigify-cli/blob/main/README.md

Examples of how to format CLI output, including piping to jq, pretty-printing, field filtering, and quiet mode for scripting.

```bash
trigify topics engagements <id> | jq '.data[] | {name, company, engagement_count}'
trigify social mapping --keywords "outbound" --pretty
trigify topics engagements <id> --fields "name,headline,company,engagement_count"
trigify searches delete <id> --quiet && echo "Deleted"
```

--------------------------------

### Trigify to Clay to Instantly Pipeline Example (Bash)

Source: https://github.com/bcharleson/trigify-cli/blob/main/README.md

A bash script demonstrating a data pipeline: exporting prospects from Trigify, enriching them with Clay, and then passing the data to Instantly for email sequencing. It highlights the use of `trigify social mapping`.

```bash
# 1. Export ICP-matched prospects from Trigify
trigify social mapping \
  --keywords "outbound sales" \
  --seniority "VP,Director" \
  --company-size "51-200" \
  --limit 100 \
  --fields "name,headline,profile_url,company,urn"

# 2. Pass profile_url column to Clay for email enrichment
# 3. Pass enriched CSV to Instantly for sequencing
```

--------------------------------

### Cursor-based Pagination Reference for Trigify CLI

Source: https://github.com/bcharleson/trigify-cli/blob/main/AGENTS.md

Example of how to use cursor-based pagination for commands like 'searches results' and 'posts engagements/comments'. This method allows for efficient retrieval of large datasets by fetching data in chunks.

```bash
# Page 1
trigify searches results <id> --limit 100
# Extract next_cursor from response, then:
trigify searches results <id> --limit 100 --cursor "<next_cursor>"
# Stop when next_cursor is null or absent
```

--------------------------------

### Get Engagements and Comments on Brand Posts (Bash)

Source: https://github.com/bcharleson/trigify-cli/blob/main/CLAUDE.md

This snippet demonstrates how to retrieve engagement data (likes and comments) for high-engagement posts related to your brand.

```bash
trigify posts engagements --url "<viral_brand_post_url>" --limit 50
trigify posts comments --url "<viral_brand_post_url>" --limit 25 --pretty
```

--------------------------------

### Deep-dive Champion Posts and Get Engagers (Bash)

Source: https://github.com/bcharleson/trigify-cli/blob/main/CLAUDE.md

This snippet demonstrates how to perform a deep-dive into a specific champion's post and identify who engaged with it, providing network intelligence.

```bash
trigify profiles posts --urn "urn:li:member:111" --limit 5 --pretty

trigify posts engagements --urn "urn:li:activity:XXXXX" --limit 25
```

--------------------------------

### Page-number-based Pagination Reference for Trigify CLI

Source: https://github.com/bcharleson/trigify-cli/blob/main/AGENTS.md

Example of how to use page-number-based pagination for commands like 'topics engagements' and 'profiles posts'. This method involves specifying page numbers and page sizes to retrieve data incrementally.

```bash
trigify topics engagements <id> --page 1 --page-size 100
trigify topics engagements <id> --page 2 --page-size 100
# Stop when returned array length < page_size
```

--------------------------------

### Create Brand Monitoring Searches (Bash)

Source: https://github.com/bcharleson/trigify-cli/blob/main/CLAUDE.md

This snippet illustrates how to set up searches for brand monitoring across multiple platforms. It includes creating general brand searches, as well as specific searches for negative signals and potential advocates.

```bash
trigify searches create \
  --name "Brand: [YourBrand] - all platforms" \
  --keywords "[YourBrand],[YourBrand.io],[YourBrand] reviews" \
  --platforms "linkedin,twitter,reddit,youtube"

trigify searches create \
  --name "Brand: [YourBrand] - negative signals" \
  --keywords "[YourBrand] problem,[YourBrand] bad,[YourBrand] doesn't work,cancel [YourBrand]"

trigify searches create \
  --name "Brand: [YourBrand] - advocates" \
  --keywords "love [YourBrand],recommend [YourBrand],[YourBrand] is amazing,[YourBrand] changed"
```

--------------------------------

### Create Competitor Searches and Topics (Bash)

Source: https://github.com/bcharleson/trigify-cli/blob/main/CLAUDE.md

This snippet demonstrates how to create searches and topics to identify and capture audiences related to competitors. It involves defining keywords, platforms, and exclusion criteria for both general searches and LinkedIn-specific engagement.

```bash
trigify searches create \
  --name "Competitor: [CompetitorName]" \
  --keywords "[CompetitorName],[CompetitorName] alternative,switching from [CompetitorName]" \
  --platforms "linkedin,twitter,reddit" \
  --exclude-keywords "job,hiring,internship"

trigify topics create \
  --name "Comp: [CompetitorName] LinkedIn engagers" \
  --keywords "[CompetitorName],[CompetitorName] users,[CompetitorName] pricing" \
  --exclude "hiring,job"
```

--------------------------------

### GET /profiles/posts

Source: https://github.com/bcharleson/trigify-cli/blob/main/AGENTS.md

Retrieves the most recent posts from a specific LinkedIn profile.

```APIDOC
## GET /profiles/posts

### Description
Fetches up to 50 of the most recent posts from a specified LinkedIn profile.

### Method
GET

### Endpoint
trigify profiles posts

### Parameters
#### Query Parameters
- **urn** (string) - Required (if url not provided) - The LinkedIn member URN.
- **url** (string) - Required (if urn not provided) - The LinkedIn profile URL.
- **limit** (integer) - Optional - Max number of posts to retrieve (max 50).

### Request Example
trigify profiles posts --urn "urn:li:member:12345678" --limit 50

### Response
#### Success Response (200)
- **data** (array) - List of post objects containing urn, url, content, published_at, likes, comments, and shares.

#### Response Example
{
  "data": [
    {
      "urn": "urn:li:activity:987654321",
      "url": "https://linkedin.com/feed/update/urn:li:activity:987654321",
      "content": "We just hit $1M ARR...",
      "published_at": "2025-03-05T08:00:00Z",
      "likes": 1243,
      "comments": 87,
      "shares": 34
    }
  ]
}
```

--------------------------------

### Manage CLI Output and Formatting

Source: https://github.com/bcharleson/trigify-cli/blob/main/AGENTS.md

Demonstrates how to handle command output using flags like --pretty, --fields, and --quiet, or by piping to external tools like jq.

```bash
trigify searches list | jq '.data[] | {id, name}'
trigify topics engagements <id> --pretty
trigify topics engagements <id> --fields "name,headline,company,engagement_count"
trigify searches delete <id> --quiet && echo "Deleted"
```

--------------------------------

### GET /posts/engagements

Source: https://github.com/bcharleson/trigify-cli/blob/main/CLAUDE.md

Retrieves a list of users who have reacted to a specific LinkedIn post.

```APIDOC
## GET /posts/engagements

### Description
Returns the list of users who liked or reacted to a post. Costs 1 credit per engager.

### Method
GET

### Endpoint
trigify posts engagements

### Parameters
#### Query Parameters
- **urn** (string) - Required (if url not provided) - The LinkedIn activity URN.
- **url** (string) - Required (if urn not provided) - The LinkedIn post URL.
- **limit** (integer) - Optional - Number of records to return.
- **cursor** (string) - Optional - Pagination cursor.

### Response
#### Success Response (200)
- **data** (array) - List of users who engaged with the post.
- **next_cursor** (string) - Cursor for the next page of results.

### Response Example
{
  "data": [
    {
      "urn": "urn:li:member:99999",
      "name": "Mike Johnson",
      "reaction_type": "like"
    }
  ],
  "next_cursor": "cursor_xyz"
}
```

--------------------------------

### GET /searches/results

Source: https://github.com/bcharleson/trigify-cli/blob/main/README.md

Retrieves the collected social media posts for a specific search ID.

```APIDOC
## GET /searches/results

### Description
Fetches paginated results for a previously created search. This operation is free and cursor-paginated.

### Method
GET

### Endpoint
trigify searches results <id>

### Parameters
#### Path Parameters
- **id** (string) - Required - The ID of the search to retrieve results for.

#### Query Parameters
- **platform** (string) - Optional - Filter results by platform.
- **limit** (integer) - Optional - Number of results to return.
- **cursor** (string) - Optional - Pagination cursor.

### Request Example
trigify searches results search_12345 --platform linkedin --limit 50

### Response
#### Success Response (200)
- **data** (array) - List of social media posts matching the search criteria.

#### Response Example
{
  "data": [
    { "id": "post_1", "content": "Example post content", "platform": "linkedin" }
  ],
  "next_cursor": "abc-123"
}
```

--------------------------------

### GET /posts/engagements

Source: https://github.com/bcharleson/trigify-cli/blob/main/AGENTS.md

Retrieves a list of users who have engaged (liked/reacted) with a specific LinkedIn post.

```APIDOC
## GET /posts/engagements

### Description
Returns a list of individuals who reacted to a specific post. Costs 1 credit per engager.

### Method
GET

### Endpoint
trigify posts engagements

### Parameters
#### Query Parameters
- **urn** (string) - Required (if url not provided) - The activity URN of the post.
- **url** (string) - Required (if urn not provided) - The URL of the post.
- **limit** (integer) - Optional - Number of engagers to return.
- **cursor** (string) - Optional - Pagination cursor.

### Response
#### Success Response (200)
- **data** (array) - List of engagers including urn, name, headline, and reaction_type.
- **next_cursor** (string) - Token for the next page of results.

#### Response Example
{
  "data": [
    {
      "urn": "urn:li:member:99999",
      "name": "Mike Johnson",
      "reaction_type": "like"
    }
  ],
  "next_cursor": "cursor_xyz"
}
```

--------------------------------

### GET /social/mapping

Source: https://github.com/bcharleson/trigify-cli/blob/main/README.md

Query the engagement graph using firmographic filters to identify high-value prospects.

```APIDOC
## GET social mapping

### Description
Filters the engagement graph based on ICP criteria such as company size, industry, and seniority.

### Method
GET

### Endpoint
trigify social mapping

### Parameters
#### Query Parameters
- **keywords** (string) - Required - Keywords to search
- **company-size** (string) - Optional - Filter by size (e.g., "51-200")
- **industry** (string) - Optional - Filter by industry
- **seniority** (string) - Optional - Filter by seniority level
- **limit** (integer) - Optional - Number of results to return

### Request Example
{
  "keywords": "outbound",
  "seniority": "VP,Director",
  "company-size": "51-200"
}

### Response
#### Success Response (200)
- **data** (array) - List of matching profiles

#### Response Example
{
  "data": [
    { "name": "John Doe", "company": "Acme Corp", "seniority": "VP" }
  ]
}
```

--------------------------------

### Create Topics for Thought Leader Audiences (Bash)

Source: https://github.com/bcharleson/trigify-cli/blob/main/CLAUDE.md

This snippet demonstrates how to create topics that target the audiences engaging with key influencers in a specific space, identifying potential buyers.

```bash
trigify topics create \
  --name "TL: [Influencer Name] audience" \
  --keywords "[Influencer Name],[Influencer Company],posts by [Influencer]"
```

--------------------------------

### POST /searches/create

Source: https://github.com/bcharleson/trigify-cli/blob/main/README.md

Creates a new social listening search to monitor keyword mentions across specified platforms.

```APIDOC
## POST /searches/create

### Description
Creates a new search configuration to monitor brand or competitor mentions across LinkedIn, Twitter, Reddit, YouTube, and Podcasts.

### Method
POST

### Endpoint
trigify searches create

### Parameters
#### Request Body
- **name** (string) - Required - A unique name for the search.
- **keywords** (string) - Required - Comma-separated list of keywords to monitor.
- **platforms** (string) - Optional - Comma-separated list of platforms (e.g., "linkedin,twitter").
- **exclude-keywords** (string) - Optional - Comma-separated list of keywords to ignore.

### Request Example
{
  "name": "Brand: MyCompany",
  "keywords": "MyCompany,MyCompany.io",
  "platforms": "linkedin,twitter,reddit"
}

### Response
#### Success Response (200)
- **id** (string) - The unique identifier for the created search.

#### Response Example
{
  "id": "search_12345",
  "status": "created"
}
```

--------------------------------

### Topics API

Source: https://context7.com/bcharleson/trigify-cli/llms.txt

Commands for creating, listing, getting, updating, deleting, and retrieving engagement data for topics.

```APIDOC
## POST /topics

### Description
Create a new topic with specified name and keywords.

### Method
POST

### Endpoint
/topics

### Parameters
#### Query Parameters
- **name** (string) - Required - The name of the topic.
- **keywords** (string) - Required - A comma-separated list of keywords for the topic.

### Request Example
```bash
trigify topics create \
  --name "TL: Outbound influencers" \
  --keywords "Morgan Ingram,Krysten Conner"
```

## GET /topics

### Description
List all topics with engagement statistics.

### Method
GET

### Endpoint
/topics

### Parameters
#### Query Parameters
- **pretty** (boolean) - Optional - Format the output for readability.
- **fields** (string) - Optional - Comma-separated list of fields to include in the output (e.g., "id,name,status,posts_found,engagements_found").

### Request Example
```bash
trigify topics list --pretty
trigify topics list --fields "id,name,status,posts_found,engagements_found"
```

## GET /topics/{topic_id}

### Description
Get details and collection status for a specific topic.

### Method
GET

### Endpoint
/topics/{topic_id}

### Parameters
#### Path Parameters
- **topic_id** (string) - Required - The ID of the topic.
#### Query Parameters
- **pretty** (boolean) - Optional - Format the output for readability.
- **fields** (string) - Optional - Comma-separated list of fields to include in the output (e.g., "posts_found,engagements_found,backfill_status").

### Request Example
```bash
trigify topics get topic_abc123 --pretty
trigify topics get topic_abc123 --fields "posts_found,engagements_found,backfill_status"
```

## PUT /topics/{topic_id}

### Description
Update a topic's name or status.

### Method
PUT

### Endpoint
/topics/{topic_id}

### Parameters
#### Path Parameters
- **topic_id** (string) - Required - The ID of the topic.
#### Query Parameters
- **name** (string) - Optional - The new name for the topic.
- **status** (string) - Optional - The new status for the topic (e.g., "paused", "active").

### Request Example
```bash
# Pause topic
trigify topics update topic_abc123 --status paused

# Resume topic
trigify topics update topic_abc123 --status active

# Rename
trigify topics update topic_abc123 --name "Renamed topic"
```

## DELETE /topics/{topic_id}

### Description
Soft-delete a topic. Stops monitoring but retains historical data.

### Method
DELETE

### Endpoint
/topics/{topic_id}

### Parameters
#### Path Parameters
- **topic_id** (string) - Required - The ID of the topic.

### Request Example
```bash
trigify topics delete topic_abc123
```

## GET /topics/{topic_id}/engagements

### Description
Get deduplicated list of people who engaged with posts matching the topic.

### Method
GET

### Endpoint
/topics/{topic_id}/engagements

### Parameters
#### Path Parameters
- **topic_id** (string) - Required - The ID of the topic.
#### Query Parameters
- **pretty** (boolean) - Optional - Format the output for readability.
- **page** (integer) - Optional - The page number for pagination.
- **page_size** (integer) - Optional - The number of results per page.
- **fields** (string) - Optional - Comma-separated list of fields to include in the output (e.g., "name,headline,company,engagement_count").

### Request Example
```bash
# Get all engagers
trigify topics engagements topic_abc123 --pretty

# Paginate through results
trigify topics engagements topic_abc123 --page 1 --page-size 100
trigify topics engagements topic_abc123 --page 2 --page-size 100

# Extract high-intent prospects
trigify topics engagements topic_abc123 \
  --fields "name,headline,company,engagement_count" \
  --pretty
```

## GET /topics/{topic_id}/posts/{post_id}/engagements

### Description
Get engagers for a specific post within a topic.

### Method
GET

### Endpoint
/topics/{topic_id}/posts/{post_id}/engagements

### Parameters
#### Path Parameters
- **topic_id** (string) - Required - The ID of the topic.
- **post_id** (string) - Required - The ID of the post.
#### Query Parameters
- **pretty** (boolean) - Optional - Format the output for readability.

### Request Example
```bash
trigify topics post-engagements topic_abc123 post_xyz789 --pretty
```

## GET /topics/{topic_id}/credits-summary

### Description
Check credit spend before pulling large datasets.

### Method
GET

### Endpoint
/topics/{topic_id}/credits-summary

### Parameters
#### Path Parameters
- **topic_id** (string) - Required - The ID of the topic.
#### Query Parameters
- **pretty** (boolean) - Optional - Format the output for readability.

### Request Example
```bash
trigify topics credits-summary topic_abc123 --pretty
```

### Response Example
```json
{
  "topic_id": "topic_abc",
  "posts_found": 412,
  "engagements_found": 2847,
  "credits_from_posts": 412,
  "credits_from_engagements": 14235,
  "total_credits_consumed": 14647
}
```
```

--------------------------------

### GET /searches/results

Source: https://github.com/bcharleson/trigify-cli/blob/main/AGENTS.md

Retrieves the results of a specific search query based on platform and time scoping.

```APIDOC
## GET /searches/results

### Description
Fetches the results for a previously created search ID, allowing for platform filtering and result limiting.

### Method
GET

### Endpoint
trigify searches results <searches_id>

### Parameters
#### Path Parameters
- **searches_id** (string) - Required - The ID of the search to retrieve.

#### Query Parameters
- **platform** (string) - Optional - Filter by platform.
- **limit** (integer) - Optional - Max number of results to return.
- **start-date** (date) - Optional - Filter results from this date.

### Request Example
trigify searches results search_12345 --platform linkedin --limit 100

### Response
#### Success Response (200)
- **results** (array) - List of matching posts/mentions.

#### Response Example
{
  "results": [
    {"id": "post_001", "content": "Example post content..."}
  ]
}
```

--------------------------------

### GET /profiles/enrich

Source: https://github.com/bcharleson/trigify-cli/blob/main/README.md

Enrich a specific LinkedIn profile URL to pull posting data and track ongoing signals.

```APIDOC
## GET profiles enrich

### Description
Retrieves detailed profile information and recent activity for a given LinkedIn URL.

### Method
GET

### Endpoint
trigify profiles enrich

### Parameters
#### Query Parameters
- **url** (string) - Required - The LinkedIn profile URL

### Request Example
{
  "url": "https://linkedin.com/in/example"
}

### Response
#### Success Response (200)
- **urn** (string) - Unique profile identifier
- **data** (object) - Profile details

#### Response Example
{
  "urn": "urn:li:member:123",
  "data": { "name": "Example User" }
}
```

--------------------------------

### Execute Signal-Led Sales Prospecting Playbook

Source: https://github.com/bcharleson/trigify-cli/blob/main/AGENTS.md

A multi-step workflow for creating intent topics, checking data status, and pulling high-intent engagers for targeted outreach.

```bash
trigify topics create --name "Pain: [your pain point]" --keywords "problem statement" --exclude "hiring,job,career"
trigify topics get <id> --fields "posts_found,engagements_found,backfill_status"
trigify topics credits-summary <id>
trigify topics engagements <id> --page-size 100 --pretty
trigify profiles posts --urn "urn:li:member:XXXXX" --limit 5 --pretty
```

--------------------------------

### GET /enrich/company

Source: https://context7.com/bcharleson/trigify-cli/llms.txt

Enriches a LinkedIn company page URL by returning firmographic data including industry, size, and location.

```APIDOC
## GET trigify enrich company

### Description
Enrich a LinkedIn company page URL to get company ID and firmographic data.

### Method
GET

### Endpoint
trigify enrich company

### Parameters
#### Query Parameters
- **url** (string) - Required - LinkedIn company URL

### Request Example
trigify enrich company --url "https://www.linkedin.com/company/openai"

### Response
#### Success Response (200)
- **id** (string) - Company identifier
- **name** (string) - Company name
- **industry** (string) - Industry sector
- **size** (string) - Employee range

#### Response Example
{
  "id": "company_123",
  "name": "OpenAI",
  "industry": "Artificial Intelligence"
}
```

--------------------------------

### Get Specific Social Listening Search Details

Source: https://context7.com/bcharleson/trigify-cli/llms.txt

Retrieves detailed information for a specific social listening search identified by its ID.

```bash
trigify searches get search_abc123 --pretty
```

--------------------------------

### POST /searches/create

Source: https://github.com/bcharleson/trigify-cli/blob/main/AGENTS.md

Creates a new search configuration to monitor keywords across multiple social platforms.

```APIDOC
## POST /searches/create

### Description
Creates a new search query to track specific keywords across platforms like LinkedIn, Twitter, and Reddit.

### Method
POST

### Endpoint
trigify searches create

### Parameters
#### Query Parameters
- **name** (string) - Required - Unique name for the search.
- **keywords** (string) - Required - Comma-separated list of keywords to track.
- **platforms** (string) - Required - Comma-separated list of platforms (linkedin, twitter, reddit, youtube).
- **exclude-keywords** (string) - Optional - Keywords to filter out of results.

### Request Example
trigify searches create --name "Competitor: Acme" --keywords "Acme,Acme alternative" --platforms "linkedin,twitter"

### Response
#### Success Response (200)
- **id** (string) - The unique identifier for the created search.

#### Response Example
{
  "status": "success",
  "id": "search_12345"
}
```

--------------------------------

### Control Output: Specific Fields

Source: https://context7.com/bcharleson/trigify-cli/llms.txt

Filters the output to include only specified fields, reducing verbosity. Example shown with `trigify topics engagements`.

```bash
trigify topics engagements topic_abc --fields "name,headline,company,engagement_count"
```

--------------------------------

### Execute Signal-Led Sales Prospecting Playbook

Source: https://github.com/bcharleson/trigify-cli/blob/main/CLAUDE.md

A multi-step workflow to identify high-intent prospects by creating topics, monitoring engagement, and filtering by ICP criteria.

```bash
# Step 1: Create intent-signal topics
trigify topics create \
  --name "Pain: [your pain point]" \
  --keywords "pain point keyword 1,pain point keyword 2,problem statement" \
  --exclude "hiring,job,career"

# Step 2: Check data has landed
trigify topics get <id> --fields "posts_found,engagements_found,backfill_status"

# Step 3: Check credit spend
trigify topics credits-summary <id>

# Step 4: Pull all engagers
trigify topics engagements <id> --page-size 100 --pretty
trigify topics engagements <id> --page 2 --page-size 100

# Step 5: Research high-intent profiles
trigify profiles posts --urn "urn:li:member:XXXXX" --limit 5 --pretty

# Step 6: Filter by ICP
trigify social mapping \
  --keywords "your pain point keywords" \
  --seniority "VP,Director" \
  --company-size "51-200" \
  --industry "SaaS" \
  --limit 50
```

--------------------------------

### Bulk Upload Profiles and Tag for ABM (Bash)

Source: https://github.com/bcharleson/trigify-cli/blob/main/CLAUDE.md

This snippet demonstrates how to perform a bulk upload of enriched profile URNs and tag them for specific account-based marketing campaigns.

```bash
trigify profiles engagement-bulk \
  --profiles "urn:li:member:111,urn:li:member:222" \
  --tag "target-account-acme-q1"

trigify profiles engagement-bulk \
  --profiles "urn:li:member:333" \
  --tag "target-account-globex-q1"
```

--------------------------------

### Create Search Monitors for Product Conversations

Source: https://github.com/bcharleson/trigify-cli/blob/main/AGENTS.md

Sets up search monitors to track conversations related to product category, feature requests, and pain points. It allows specifying keywords and platforms like Reddit, LinkedIn, and Twitter.

```bash
trigify searches create \
  --name "Product: feature requests" \
  --keywords "wish [product category] could,[product category] needs,missing feature [product]" \
  --platforms "reddit,linkedin,twitter"
```

```bash
trigify searches create \
  --name "Product: pain points" \
  --keywords "[problem space] is broken,[pain point] still sucks,why can't [product category]" \
  --platforms "reddit,twitter"
```

--------------------------------

### Get Company Posts by URL

Source: https://context7.com/bcharleson/trigify-cli/llms.txt

Retrieves recent posts from a LinkedIn company page, identified by its URL. Requires the 'trigify' CLI tool.

```bash
trigify company posts \
  --url "https://www.linkedin.com/company/trigify" \
  --limit 10 \
  --pretty
```

```bash
trigify company posts \
  --url "https://linkedin.com/company/hubspot" \
  --limit 25
```

--------------------------------

### Get LinkedIn Post Engagements by Tag

Source: https://context7.com/bcharleson/trigify-cli/llms.txt

Retrieves engagement data for posts from profiles tagged with a specific identifier. Requires the 'trigify' CLI tool.

```bash
trigify profiles engagement-post-results --tag "icp-tier-1-q1-2025" --pretty
```

--------------------------------

### Manage Social Listening Searches

Source: https://github.com/bcharleson/trigify-cli/blob/main/CLAUDE.md

Tools to create, list, retrieve, update, and delete keyword-based monitors. These commands allow users to configure tracking for brands, competitors, and market trends.

```bash
trigify searches create --name "Brand: Trigify" --keywords "Trigify" --platforms "linkedin,twitter,reddit"
trigify searches list --fields "id,name,status" --pretty
trigify searches get <id> --pretty
trigify searches update <id> --status paused
trigify searches delete <id>
```

--------------------------------

### Get LinkedIn Post Engagements by URN

Source: https://context7.com/bcharleson/trigify-cli/llms.txt

Retrieves engagement data for posts from a specific LinkedIn profile identified by its URN. Requires the 'trigify' CLI tool.

```bash
trigify profiles engagement-post-results --urn "urn:li:member:12345678"
```

--------------------------------

### List and Monitor Brand Search Results (Bash)

Source: https://github.com/bcharleson/trigify-cli/blob/main/CLAUDE.md

This snippet shows how to list existing brand searches and monitor their results with time scoping. It includes fetching results for specific platforms like Twitter and Reddit within a defined date range.

```bash
trigify searches list --fields "id,name,status"

trigify searches results <id> --start-date 2025-03-01 --limit 100 --platform twitter
trigify searches results <id> --start-date 2025-03-01 --limit 100 --platform reddit
```

--------------------------------

### ABM Signal Tracking and Enrichment

Source: https://context7.com/bcharleson/trigify-cli/llms.txt

Workflows for enriching champion profiles, bulk tracking engagement, and monitoring activity for specific target accounts.

```bash
trigify profiles enrich --url "https://linkedin.com/in/champion-name"
trigify profiles engagement-bulk --profiles "urn:li:member:111,urn:li:member:222" --tag "target-acme-q1"
trigify profiles engagement-results --tag "target-acme-q1" --pretty
trigify profiles engagement-post-results --tag "target-acme-q1" --pretty
trigify posts engagements --urn "urn:li:activity:xxx" --limit 25
trigify posts comments --urn "urn:li:activity:xxx" --limit 25
trigify enrich company --url "https://linkedin.com/company/acme-corp" --pretty
```

--------------------------------

### Authenticate with Trigify API Key

Source: https://context7.com/bcharleson/trigify-cli/llms.txt

Demonstrates how to authenticate with the Trigify API using various methods: interactive prompt, environment variable, direct flag, or per-command authentication. This is necessary for making authenticated requests.

```bash
# Store API key interactively
trigify login

# Store API key directly (recommended for CI/scripts)
trigify login --api-key your-api-key-here

# Using environment variable
export TRIGIFY_API_KEY=your-api-key
trigify searches list

# Per-command authentication
trigify --api-key your-api-key searches list
```

--------------------------------

### Control Output: Pretty-Printed

Source: https://context7.com/bcharleson/trigify-cli/llms.txt

Formats CLI output in a human-readable, pretty-printed JSON format using the `--pretty` flag. Example shown with `trigify topics engagements`.

```bash
trigify topics engagements topic_abc --pretty
```

--------------------------------

### Control Output: Compact JSON

Source: https://context7.com/bcharleson/trigify-cli/llms.txt

Formats CLI output as compact JSON, suitable for piping to other tools like `jq`. Example shown with `trigify searches list`.

```bash
trigify searches list | jq '.data[] | {id, name}'
```

--------------------------------

### Check Account Activity and Read Champion Posts (Bash)

Source: https://github.com/bcharleson/trigify-cli/blob/main/CLAUDE.md

This snippet shows how to check the activity of tagged accounts at the profile level and read the posts made by champions within those accounts.

```bash
trigify profiles engagement-results --tag "target-account-acme-q1" --pretty

trigify profiles engagement-post-results --tag "target-account-acme-q1" --pretty
```

--------------------------------

### Get Comments from a Post

Source: https://github.com/bcharleson/trigify-cli/blob/main/AGENTS.md

Retrieves all comments made on a specific post URN. This is useful for analyzing discussions and gathering insights from user feedback on viral content.

```bash
trigify posts comments --urn "<post_urn>" --limit 50 --pretty
```

--------------------------------

### Handle API Pagination

Source: https://github.com/bcharleson/trigify-cli/blob/main/CLAUDE.md

Demonstrates cursor-based and page-number-based pagination patterns for retrieving large datasets from Trigify API endpoints.

```bash
# Cursor-based
trigify searches results <id> --limit 100
trigify searches results <id> --limit 100 --cursor "<next_cursor>"

# Page-number-based
trigify topics engagements <id> --page 1 --page-size 100
trigify topics engagements <id> --page 2 --page-size 100
```

--------------------------------

### List Topics with Engagement Metrics

Source: https://github.com/bcharleson/trigify-cli/blob/main/AGENTS.md

Lists all created topics and displays key metrics such as ID, name, posts found, engagements found, and status. This helps in monitoring the activity across different segments.

```bash
trigify topics list --fields "id,name,posts_found,engagements_found,status"
```

--------------------------------

### Get Replies to Top Comments on a Post

Source: https://github.com/bcharleson/trigify-cli/blob/main/AGENTS.md

Fetches replies to the top comments of a given post URN. This helps in identifying high-intent discussions and detailed feedback from users.

```bash
trigify posts comment_replies \
  --post-urn "<post_urn>" \
  --comment-urn "<top_comment_urn>" \
  --limit 20
```

--------------------------------

### Create Search Monitors for Competitor Gaps

Source: https://github.com/bcharleson/trigify-cli/blob/main/AGENTS.md

Establishes search monitors to identify competitor weaknesses and feature gaps by looking for complaints or limitations mentioned about specific competitors on platforms like Reddit, Twitter, and LinkedIn.

```bash
trigify searches create \
  --name "Product: competitor gaps" \
  --keywords "[Competitor] doesn't have,[Competitor] missing,[Competitor] can't do" \
  --platforms "reddit,twitter,linkedin"
```

--------------------------------

### Get Full Comment Thread from a Post

Source: https://github.com/bcharleson/trigify-cli/blob/main/AGENTS.md

Fetches all comments associated with a specific post URL. This is useful for deep analysis of discussions, especially for high-engagement product-related posts.

```bash
trigify posts comments --url "<high_engagement_product_post>" --limit 50 --pretty
```

--------------------------------

### Create a Social Listening Search

Source: https://context7.com/bcharleson/trigify-cli/llms.txt

Creates a new social listening search to monitor keyword mentions across specified platforms. Supports basic brand monitoring, competitor intelligence with exclusions, and multi-platform market research.

```bash
# Basic brand monitoring search
trigify searches create \
  --name "Brand: MyCompany" \
  --keywords "MyCompany,MyCompany.io" \
  --platforms "linkedin,twitter,reddit"

# Competitor intelligence with exclusions
trigify searches create \
  --name "Competitor: HubSpot" \
  --keywords "HubSpot CRM,HubSpot alternative" \
  --exclude-keywords "hiring,job,career"

# Multi-platform market research
trigify searches create \
  --name "Market: AI sales tools" \
  --keywords "AI SDR,AI for sales,AI outbound" \
  --platforms "linkedin,reddit,youtube,podcasts"
```

--------------------------------

### Get Recent Posts from Profiles

Source: https://github.com/bcharleson/trigify-cli/blob/main/AGENTS.md

Fetches the most recent posts from a given profile URN. This is useful for analyzing the content shared by high-engagement individuals identified in previous steps.

```bash
trigify profiles posts --urn "<high_engager_urn>" --limit 5
```

--------------------------------

### Connect X (Twitter) Account

Source: https://context7.com/bcharleson/trigify-cli/llms.txt

Initiates the OAuth connection process for your X (Twitter) account, providing a URL and status. This is a prerequisite for other X commands. Uses the 'trigify' CLI tool.

```bash
trigify x connect --pretty
```

--------------------------------

### Summarize Topic Credits Usage

Source: https://github.com/bcharleson/trigify-cli/blob/main/AGENTS.md

Provides a summary of credit usage for specific topic IDs. This command helps in understanding the resource consumption for monitoring different segments.

```bash
trigify topics credits-summary <seg1_id>
```

```bash
trigify topics credits-summary <seg2_id>
```

--------------------------------

### Control Output: Quiet Mode

Source: https://context7.com/bcharleson/trigify-cli/llms.txt

Suppresses all output except for the exit code, useful for scripting. The example shows checking for successful deletion using `&& echo`. Uses the `trigify` CLI.

```bash
trigify searches delete search_abc --quiet && echo "Deleted"
```

--------------------------------

### Get Engagers (Reactions/Likes) from a Viral Post

Source: https://github.com/bcharleson/trigify-cli/blob/main/AGENTS.md

Captures all users who reacted to or liked a viral post. This command supports pagination using a cursor for retrieving a complete list of engagers.

```bash
trigify posts engagements --url "<viral_post_url>" --limit 100
```

```bash
trigify posts engagements --urn "<post_urn>" --limit 100 --cursor "<cursor>"
```

--------------------------------

### GET /posts/engagements

Source: https://context7.com/bcharleson/trigify-cli/llms.txt

Retrieves a list of users who have engaged (liked, commented, shared) with a specific LinkedIn post. This endpoint is part of the Enterprise suite and incurs a cost of 1 credit per engager.

```APIDOC
## GET trigify posts engagements

### Description
Retrieve list of users who engaged with a LinkedIn post via URL or URN.

### Method
GET

### Endpoint
trigify posts engagements

### Parameters
#### Query Parameters
- **url** (string) - Optional - LinkedIn post URL
- **urn** (string) - Optional - LinkedIn post URN
- **limit** (integer) - Optional - Number of results to return
- **cursor** (string) - Optional - Pagination cursor

### Request Example
trigify posts engagements --url "https://www.linkedin.com/feed/update/urn:li:activity:123456789" --limit 25

### Response
#### Success Response (200)
- **data** (array) - List of engagers

#### Response Example
{
  "data": [{"id": "urn:li:member:123", "name": "John Doe"}]
}
```

--------------------------------

### Create ICP Topics with Keywords

Source: https://github.com/bcharleson/trigify-cli/blob/main/AGENTS.md

This command creates a new topic for identifying Ideal Customer Profile (ICP) keywords, combining influencer keywords with specific terms like 'outbound' and 'cold email'. It's used to layer ICP insights with engagement data.

```bash
trigify topics create \
  --name "ICP + TL: [space] leaders" \
  --keywords "[influencer keyword 1],[influencer keyword 2],outbound,cold email"
```

--------------------------------

### Create Segment-Specific Topics

Source: https://github.com/bcharleson/trigify-cli/blob/main/AGENTS.md

Creates distinct topics tailored for different market segments, such as 'Mid-market RevOps', 'Enterprise Sales Leaders', 'Startup Founders fundraising', and 'SDR/BDR managers'. Each topic is defined by relevant keywords.

```bash
trigify topics create --name "Seg: Mid-market RevOps" \
  --keywords "RevOps,revenue operations,GTM motion,revenue efficiency"
```

```bash
trigify topics create --name "Seg: Enterprise Sales Leaders" \
  --keywords "enterprise sales,complex sales,sales transformation,sales methodology"
```

```bash
trigify topics create --name "Seg: Startup Founders fundraising" \
  --keywords "just raised,Series A,seed round,we closed our"
```

```bash
trigify topics create --name "Seg: SDR/BDR managers" \
  --keywords "SDR team,BDR team,outbound team,sales development"
```

--------------------------------

### Get LinkedIn Post Comments by URL

Source: https://context7.com/bcharleson/trigify-cli/llms.txt

Retrieves comments made on a specific LinkedIn post, identified by its URL. Costs 1 credit per comment. Requires the 'trigify' CLI tool.

```bash
trigify posts comments \
  --url "https://linkedin.com/feed/update/urn:li:activity:123" \
  --limit 25
```