# Social & Market Research MCP (`themineworks/social-research-mcp`) Actor

What the internet is saying — Reddit, X, Threads, LinkedIn, YouTube transcripts, Google News and Trends behind one MCP endpoint. No result, no charge.

- **URL**: https://apify.com/themineworks/social-research-mcp.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** MCP servers, Social media
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $40.00 / 1,000 reddit searches

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Social & Market Research MCP

**What is the internet actually saying about this? Ask once, get Reddit, X, Threads, LinkedIn, news, and search interest.**

Your agent shouldn't need six scrapers and six integrations to answer one question about a brand. Eight tools behind one MCP endpoint, normalized JSON, and you only pay for what comes back.

Built by [The Mine Works](https://apify.com/themineworks).

### Tools

| Tool | What it returns | Price |
|---|---|---|
| `search_reddit` | Posts by keyword or subreddit, with scores and optional comments | $0.04 / 25 posts |
| `search_x` | X (Twitter) posts by keyword or handle, with engagement | $0.025 / 25 posts |
| `search_threads` | Threads posts by keyword, hashtag, or profile | $0.05 / 25 posts |
| `linkedin_posts` | Public LinkedIn posts by keyword | $0.05 / 25 posts |
| `news_search` | Google News coverage with source and date | $0.05 / 25 articles |
| `google_trends` | Interest over time, related queries, regional breakdown | $0.15 |
| `youtube_transcript` | Full spoken transcript of a video, no API key | $0.02 |
| `brand_pulse_report` | All six social sources for one topic, in one call | **$0.25** complete · $0.10 partial · $0.025/source · $0 nothing found |

**The pulse report always costs less than calling the sources one by one.**

### Worked example

Ask your agent: *"What are people saying about Notion this week, and is interest rising?"*

```json
// tools/call → brand_pulse_report
{ "topic": "Notion", "geo": "US" }
```

Returns one object with a `reddit`, `x`, `threads`, `linkedin`, `news`, and `search_interest` section — each either real data or an explicit `{found: false, reason}` so your agent knows what it's missing rather than guessing.

### Setup

```json
{
  "mcpServers": {
    "social-research": {
      "url": "https://themineworks--social-research-mcp.apify.actor/mcp",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}
```

Works in Claude Desktop, Claude Code, Cursor, and Windsurf. Cold start ~9s; warm calls answer in about a second.

### Billing promise

**No result, no charge. Ever.**

- Searches that return nothing cost nothing.
- Identical repeat calls within 60 seconds are free.
- The pulse report is priced by what it actually delivered — $0.25 complete, $0.10 partial, or $0.025 per source.
- Slow sources are dropped after 45 seconds so the report stays fast; you pay the lower tier rather than waiting.

Apify platform usage is billed by Apify on top, as with any Standby actor.

### Honest limits

- **Reddit** is fetched without OAuth credentials, so heavy bursts can hit Reddit's rate limits and return short. You are not charged when that happens.
- **YouTube transcripts** depend on the video having captions; videos without them return a not-found, unbilled.
- **X (Twitter)** is the slowest source and can take 30-90s on broad queries.
- Nothing here is historical archive data — these are live reads of what is public right now.

### More from The Mine Works

The individual scrapers behind these tools are published separately at [apify.com/themineworks](https://apify.com/themineworks). Full MCP suite: [themineworks.com/mcp](https://themineworks.com/mcp).

# Actor input Schema

## `readme` (type: `string`):

This Actor serves Reddit, X, Threads, LinkedIn posts, Google News, Trends and YouTube transcripts to AI agents over the Model Context Protocol.

Connect your MCP client to:
https://themineworks--social-research-mcp.apify.actor/mcp

with your Apify API token as a Bearer token. Works in Claude Desktop, Claude Code, Cursor and Windsurf — copy-paste config blocks are in the README.

Starting a normal run here does nothing except print this pointer.

## Actor input object example

```json
{
  "readme": "Connect your MCP client to https://themineworks--social-research-mcp.apify.actor/mcp — see the README."
}
```

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/social-research-mcp").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/social-research-mcp").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 '{}' |
apify call themineworks/social-research-mcp --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/XBCL2MIulbECosJcy/builds/oammIrzQDrfDWEZRr/openapi.json