Social Research MCP

Social listening for AI agents over one remote MCP endpoint: Reddit, X, Threads, LinkedIn posts, YouTube transcripts, Google News and Google Trends. 8 tools. Hosted on Apify, pay per result, and a search that comes back empty is not billed.

View on apify.comTry this MCPSponsored

Hosted MCP Server

npx add-mcp 'https://themineworks--social-research-mcp.apify.actor/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Social Research MCP | 8 Tools: Reddit, X, Threads, News (`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 (community)
Categories: MCP servers, Social media
Stats: 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
User rating: No ratings yet

Pricing

from $75.00 / 1,000 search_reddits

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/actors/running/actors-in-store.md#pay-per-event

What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the API section below.

Each client library has reference documentation the quickstart does not restate: JavaScript/TypeScript (npm install apify-client) and Python (pip install apify-client).

README

Social Research MCP: 8 Tools: Reddit, X, Threads, News

Pay only for results delivered. Browse all Actors.

💰 $0.0025 / call.

Guide and FAQs: Social Research MCP on themineworks.com.

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.

What the Social Research MCP can do

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.

Find out what the internet is saying about a brand

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

// 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.

Search news coverage of a topic by country

// tools/call → news_search
{ "query": "lab grown diamonds", "topic": "BUSINESS", "country": "US", "max_results": 50 }

Pull the latest posts on X for a keyword or handle

// tools/call → search_x
{ "query": "product launch", "filter": "latest", "max_tweets": 50 }

Get the transcript of a YouTube video

// tools/call → youtube_transcript
{ "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "language": "en" }

Connect the Social Research MCP to Claude, Cursor or Windsurf

{
  "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.

What does the Social Research MCP cost

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.

What this social research MCP does not cover

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 social and news data actors from The Mine Works

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

Last verified: 2026-08

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

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

Actor output Schema

`mcpEndpoint` (type: `string`):

Streamable HTTP MCP endpoint for this run. Works in Claude Desktop, Claude Code, Cursor and Windsurf; copy-paste config is in 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

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

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(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

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

CLI example

echo '{}' |
apify call themineworks/social-research-mcp --silent --output-dataset

MCP server setup

{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/social-research-mcp"
        }
    }
}

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an Authorization: Bearer <APIFY_API_TOKEN> header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

OpenAPI specification

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