# Hero Signal Detector - Never Miss Customer Success Stories (`shashghosh/hero-signal-detector`)

🔍 Step 2: Real-time alerts for customer milestones - part of GTM Alpha Hero System

Monitor social media & news to capture success stories as they happen. Perfect follow-up to Hero Customer Discovery.

✅ Track 50+ platforms ✅ Reduce collection time 90% ✅ Real-time alerts

- **URL**: https://beta-securitybyobscurity.apify.com/shashghosh/hero-signal-detector.md
- **Developed by:** [Shashwat Ghosh](https://beta-securitybyobscurity.apify.com/shashghosh) (community)
- **Categories:** Social media, News, Lead generation
- **Stats:** 7 total users, 3 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

$2.00 / 1,000 results

This Actor is paid per result. You are not charged for the Apify platform usage, but only a fixed price for dataset items the Actor outputs.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-result

# README

## 🔍 Hero Signal Detector - Never Miss Customer Success Stories

**Step 2 of the GTM Alpha Hero System - Real-time monitoring of customer success milestones**

*Created by Shashwat Ghosh - Award-winning B2B Marketer of the Year 2020 (CMO Asia)*

***

### 🎯 What This Actor Does

The Hero Signal Detector provides real-time monitoring of customer success stories, milestones, and transformation narratives across 50+ digital platforms. Built on proven GTM Alpha methodology, it captures success signals as they happen, enabling immediate follow-up for testimonial and case study development.

#### Key Capabilities

- **📡 Real-Time Monitoring**: Continuous scanning of news, reviews, and social platforms
- **🎯 Signal Intelligence**: AI-powered detection of success indicators and milestones
- **🚨 Instant Alerts**: Immediate notifications when customers achieve significant outcomes
- **🔗 System Integration**: Seamlessly follows Hero Customer Discovery for complete pipeline

#### Verified Performance Metrics

- **90% Reduction** in manual monitoring time vs traditional methods
- **Real-Time Detection** within 4-6 hours of publication
- **85%+ Accuracy** in identifying genuine success stories
- **50+ Platform Coverage** including news, reviews, social media, publications

***

### 🏆 GTM Alpha Hero System Integration

This actor is **Step 2** of the scientifically-designed Hero-Making System:

1. **🏆 Hero Customer Discovery** - Identify high-potential customers
2. **🔍 Hero Signal Detector** (This Actor) - Real-time success monitoring
3. **🔗 Hero LinkedIn Analyzer** - Executive thought leadership tracking
4. **📊 Hero Content Analyzer** - Transformation story identification
5. **📈 Hero Report Generator** - Comprehensive intelligence reports

**Optimal Workflow**: Use after Hero Customer Discovery to monitor identified prospects for success signals

***

### 👨‍💼 Expert Authority & Experience

#### Creator: Shashwat Ghosh

- **🏆 B2B Marketer of the Year 2020** - CMO Asia (Fintech Category)
- **🎯 LinkedIn Top Voice** - #10 Product Marketing Creator India, #52 Worldwide
- **📚 Education**: NIT Rourkela, École des Ponts ParisTech, XLRI Jamshedpur
- **💼 Experience**: 24+ years Enterprise B2B, 8+ years Fractional CMO
- **🌍 Geographic Expertise**: India, APAC, MEA, US, UK markets

#### Signal Detection Expertise

- **Customer Success Tracking** - 100+ implementations across enterprise clients
- **Social Listening Strategy** - Proven methodologies for B2B success monitoring
- **Alert System Design** - Real-time notification systems for sales teams
- **Multi-Platform Integration** - Comprehensive monitoring across digital channels

***

### 💰 ROI & Business Impact

#### Quantified Benefits

- **Replace 15+ hours** of manual social monitoring per week
- **Capture 95%+ success stories** that would otherwise be missed
- **Reduce response time** from days to hours for testimonial requests
- **Increase testimonial collection** by 60% through timely outreach
- **Cost Efficiency**: $2 per 1,000 signals vs $25/hour manual monitoring

#### Success Story Recovery

- **Time-Sensitive Opportunities** - Catch success stories within 24-48 hours
- **Competitive Intelligence** - Monitor competitor customer successes
- **Trend Identification** - Spot patterns in customer achievement types
- **Relationship Building** - Immediate congratulatory outreach opportunities

***

### 🎯 Perfect For These Professionals

#### Primary Users

- **Marketing Directors** building systematic testimonial collection processes
- **Customer Success Managers** tracking client milestone achievements
- **Social Media Managers** monitoring brand mentions and success stories
- **Sales Directors** needing real-time customer success intelligence
- **Brand Managers** protecting and enhancing company reputation

#### Secondary Users

- **PR Teams** identifying positive coverage opportunities
- **Content Marketing** teams sourcing customer success narratives
- **Business Development** professionals tracking prospect achievements
- **Competitive Intelligence** analysts monitoring market dynamics

***

### 🔧 Technical Specifications

#### Monitoring Platforms Covered

**News & Publications:**

- Industry trade publications
- Business news websites
- Company press releases
- Financial news platforms

**Review Platforms:**

- G2, Capterra, TrustRadius
- Industry-specific review sites
- Enterprise software directories
- Professional service reviews

**Social Media (Optional):**

- LinkedIn company/personal posts
- Twitter business updates
- Professional forums
- Industry communities

#### Input Configuration

````json
{
  "companyName": "string",
  "monitoringTargets": "reviews,publications,news,social",
  "signalTypes": "transformation,success,milestone",
  "alertThreshold": "low|medium|high",
  "enableSocialMedia": "boolean",
  "delayBetweenRequests": "number",
  "maxConcurrency": "number"
}
#### Output Configuration
```json
{
  "signalId": "unique_identifier",
  "detectionTime": "timestamp",
  "source": "platform_name",
  "signalType": "transformation|success|milestone",
  "companyMentioned": "string",
  "content": "extracted_text",
  "sentiment": "positive|neutral|negative",
  "urgency": "low|medium|high|critical",
  "actionableInsights": "array",
  "followUpRecommendations": "array"
}

# Actor input Schema

## `companyName` (type: `string`):

Name of the company to monitor for hero signals
## `monitoringTargets` (type: `string`):

Select which sources to monitor for hero signals
## `signalTypes` (type: `string`):

Types of hero signals to detect (comma-separated)
## `alertThreshold` (type: `string`):

Minimum quality threshold for generating alerts
## `enableSocialMedia` (type: `boolean`):

Enable LinkedIn/Twitter monitoring (requires cookies for enhanced access)
## `linkedinCookies` (type: `string`):

LinkedIn session cookies in JSON format - use Cookie-Editor browser extension to export
## `twitterCookies` (type: `string`):

Twitter session cookies in JSON format - use Cookie-Editor browser extension to export
## `delayBetweenRequests` (type: `integer`):

Delay in milliseconds between requests to avoid rate limiting and account blocks
## `maxConcurrency` (type: `integer`):

Maximum number of concurrent requests (keep low to avoid bans)

## Actor input object example

```json
{
  "companyName": "Slack Technologies",
  "monitoringTargets": "reviews,publications,news",
  "signalTypes": "transformation,success,milestone",
  "alertThreshold": "medium",
  "enableSocialMedia": false,
  "delayBetweenRequests": 3000,
  "maxConcurrency": 1
}
````

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "companyName": "Slack Technologies",
    "monitoringTargets": "reviews,publications,news",
    "signalTypes": "transformation,success,milestone",
    "alertThreshold": "medium",
    "enableSocialMedia": false,
    "delayBetweenRequests": 3000,
    "maxConcurrency": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("shashghosh/hero-signal-detector").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "companyName": "Slack Technologies",
    "monitoringTargets": "reviews,publications,news",
    "signalTypes": "transformation,success,milestone",
    "alertThreshold": "medium",
    "enableSocialMedia": False,
    "delayBetweenRequests": 3000,
    "maxConcurrency": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("shashghosh/hero-signal-detector").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "companyName": "Slack Technologies",
  "monitoringTargets": "reviews,publications,news",
  "signalTypes": "transformation,success,milestone",
  "alertThreshold": "medium",
  "enableSocialMedia": false,
  "delayBetweenRequests": 3000,
  "maxConcurrency": 1
}' |
apify call shashghosh/hero-signal-detector --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=shashghosh/hero-signal-detector",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Hero Signal Detector - Never Miss Customer Success Stories",
        "description": "🔍 Step 2: Real-time alerts for customer milestones - part of GTM Alpha Hero System\n\nMonitor social media & news to capture success stories as they happen. Perfect follow-up to Hero Customer Discovery.\n\n✅ Track 50+ platforms ✅ Reduce collection time 90% ✅ Real-time alerts",
        "version": "1.0",
        "x-build-id": "wFHSdbpjbZlwMcKSs"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/shashghosh~hero-signal-detector/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-shashghosh-hero-signal-detector",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/shashghosh~hero-signal-detector/runs": {
            "post": {
                "operationId": "runs-sync-shashghosh-hero-signal-detector",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/shashghosh~hero-signal-detector/run-sync": {
            "post": {
                "operationId": "run-sync-shashghosh-hero-signal-detector",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "companyName"
                ],
                "properties": {
                    "companyName": {
                        "title": "🏢 Company Name",
                        "type": "string",
                        "description": "Name of the company to monitor for hero signals"
                    },
                    "monitoringTargets": {
                        "title": "🎯 Monitoring Targets",
                        "enum": [
                            "reviews",
                            "publications",
                            "news",
                            "social",
                            "reviews,publications",
                            "reviews,news",
                            "publications,news",
                            "reviews,publications,news",
                            "social,reviews,publications,news"
                        ],
                        "type": "string",
                        "description": "Select which sources to monitor for hero signals",
                        "default": "reviews,publications,news"
                    },
                    "signalTypes": {
                        "title": "🔍 Signal Types",
                        "type": "string",
                        "description": "Types of hero signals to detect (comma-separated)",
                        "default": "transformation,success,milestone"
                    },
                    "alertThreshold": {
                        "title": "🚨 Alert Threshold",
                        "enum": [
                            "low",
                            "medium",
                            "high"
                        ],
                        "type": "string",
                        "description": "Minimum quality threshold for generating alerts",
                        "default": "medium"
                    },
                    "enableSocialMedia": {
                        "title": "📱 Enable Social Media Monitoring",
                        "type": "boolean",
                        "description": "Enable LinkedIn/Twitter monitoring (requires cookies for enhanced access)",
                        "default": false
                    },
                    "linkedinCookies": {
                        "title": "🍪 LinkedIn Cookies (Optional)",
                        "type": "string",
                        "description": "LinkedIn session cookies in JSON format - use Cookie-Editor browser extension to export"
                    },
                    "twitterCookies": {
                        "title": "🐦 Twitter Cookies (Optional)",
                        "type": "string",
                        "description": "Twitter session cookies in JSON format - use Cookie-Editor browser extension to export"
                    },
                    "delayBetweenRequests": {
                        "title": "⏱️ Delay Between Requests (ms)",
                        "minimum": 1000,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "Delay in milliseconds between requests to avoid rate limiting and account blocks",
                        "default": 3000
                    },
                    "maxConcurrency": {
                        "title": "🔄 Max Concurrency",
                        "minimum": 1,
                        "maximum": 3,
                        "type": "integer",
                        "description": "Maximum number of concurrent requests (keep low to avoid bans)",
                        "default": 1
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
