PostCrawl MCP Server

PostCrawl MCP Server

Note: All parameters use snake_case naming convention (e.g., social_platforms, include_comments)

search Tool

Search for posts across social media platforms (Reddit and TikTok).

Request Format

{
  "query": "artificial intelligence",
  "page": 1,
  "results": 10,
  "social_platforms": ["reddit", "tiktok"]
}

Parameters:

  • query (required): Search query string
  • page: Page number (default: 1)
  • results: Number of results (default: 10, max: 100)
  • social_platforms: Array of platforms

Response Format

[{
  "title": "AI Discussion Thread",
  "url": "https://reddit.com/r/...",
  "snippet": "Discussing the latest...",
  "date": "Dec 28, 2024",
  "imageUrl": "https://..."
}]

Returns an array of search results with formatted date strings.

extract Tool

Extract content from specific Reddit or TikTok URLs.

Request Format

{
  "urls": [
    "https://reddit.com/r/...",
    "https://tiktok.com/@..."
  ],
  "include_comments": true,
  "response_mode": "markdown"
}

Parameters:

  • urls (required): Array of URLs to extract
  • include_comments: Include comments (default: false)
  • response_mode: "raw" or "markdown" (default: "raw")

Response Format

[{
  "url": "https://reddit.com/r/...",
  "source": "reddit",
  "raw": {
    "id": "abc123",
    "title": "Post Title",
    "description": "Post content...",
    "upvotes": 1234,
    "comments": [...]
  },
  "markdown": "# Post Title

...",
  "error": null
}]

Returns extracted posts with platform-specific data.

search_and_extract Tool

Combined search and extract operation - searches for posts and automatically extracts their content.

Request Format

{
  "query": "machine learning",
  "page": 1,
  "results": 5,
  "social_platforms": ["reddit"],
  "include_comments": true,
  "response_mode": "markdown"
}

Parameters:

  • query (required): Search query
  • page: Page number
  • results: Number of results to extract
  • social_platforms: Platforms to search
  • include_comments: Extract comments
  • response_mode: Output format

Response Format

[{
  "url": "https://reddit.com/r/...",
  "source": "reddit",
  "raw": { /* full post data */ },
  "markdown": "# Post Title

...",
  "error": null
}]

Returns extracted posts from search results.

check_health Tool

Check the health status of the PostCrawl API.

Request Format

{}
// No parameters required

Response Format

{
  "status": "OK"
}

Authentication Required

All tools require a valid PostCrawl API key passed as a Bearer token in the Authorization header: 

Authorization: Bearer sk_your_api_key_here

Supported Platforms

🟠
Reddit

Extract posts, comments, and discussions

âš«
TikTok

Extract videos, comments, and metadata