Veedcrawl MCP Server

Give your AI agent eyes on the entire social video web — not just individual links.

The official Model Context Protocol server for Veedcrawl. Drop it into Claude, Cursor, or any MCP-compatible host and your agent can search social videos, pull metadata and transcripts, run structured extraction, and inspect public creator profiles across YouTube, TikTok, Instagram, X/Twitter, and Facebook.

What your agent can do

Why discovery tools change everything

Every other video API requires a public video URL. That leaves an agent stuck doing retrieval for content already found.

search_social_videos, get_tiktok_profile, and get_instagram_profile unlock discovery. Search a category or inspect a creator, select the videos that matter, then chain them into transcripts and extraction without collecting URLs by hand.

Find videos by topic, then analyze the winners:

search_social_videos(query="skincare morning routine", sort="most_liked", timePeriod="past_month")
→ normalized TikTok, Instagram, and YouTube video results
→ get_video_transcript(url=top_video.url)
→ extract_from_video(url=top_video.url, prompt="Extract the hook, claims, and CTA")

Audit a creator from scratch:

get_instagram_profile(username="hubermanlab", limit=50)
→ 283M followers, verified, recent posts with view/like counts
→ get_video_transcript(url=top_video.url)
→ extract_from_video(url=top_video.url, prompt="List every health claim made and the evidence cited")

Competitive analysis with no prep work:

get_tiktok_profile(username=competitor_A, limit=50)
get_tiktok_profile(username=competitor_B, limit=50)
get_tiktok_profile(username=competitor_C, limit=50)
→ Compare posting frequency, avg views, top hashtags, engagement rates across all three

Installation

npm install -g @veedcrawl/mcp

Get your API key at veedcrawl.com.

Setup

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "veedcrawl": {
      "command": "veedcrawl-mcp",
      "env": {
        "VEEDCRAWL_API_KEY": "ma_your_key_here"
      }
    }
  }
}

Restart Claude Desktop. The six tools will appear automatically.

Claude Code

claude mcp add veedcrawl -- env VEEDCRAWL_API_KEY=ma_your_key_here veedcrawl-mcp

Cursor

Add to your Cursor MCP config (~/.cursor/mcp.json):

{
  "mcpServers": {
    "veedcrawl": {
      "command": "veedcrawl-mcp",
      "env": {
        "VEEDCRAWL_API_KEY": "ma_your_key_here"
      }
    }
  }
}

Windsurf / Codeium

{
  "mcpServers": {
    "veedcrawl": {
      "command": "veedcrawl-mcp",
      "env": {
        "VEEDCRAWL_API_KEY": "ma_your_key_here"
      }
    }
  }
}

Tools reference

search_social_videos

Search public videos by topic, keyword, creator, or trend. Polling and retries are handled internally so the tool returns the completed search job with normalized video metadata.

Each result includes a public video URL you can pass directly into get_video_metadata, get_video_transcript, or extract_from_video.

get_video_metadata

Fetch structured metadata for any public video URL.

Returns: platform, title, description, author info, view/like/comment/share counts, duration, thumbnails, tags, publish timestamp.

get_video_transcript

Return the complete transcript for a video. Polling and retries are handled internally — your agent gets the finished result.

extract_from_video

Ask any question about a video and get a structured answer. Optionally enforce output shape with a JSON Schema.

Example prompts that work well:

• "Extract the hook, main argument, and call to action"
• "List every product mentioned with the timestamp it appears"
• "What claims does the speaker make? Rate each one as factual, opinion, or unverified"
• "Rewrite this as a Twitter thread"

get_tiktok_profile

Fetch a TikTok creator's public profile snapshot. Returns author info, total video count, and their most recent videos with full engagement stats per video.

Each video in the response is a full object with views, likes, comments, shares, caption, hashtags, thumbnail, and publish timestamp — ready to pass directly into get_video_transcript or extract_from_video.

get_instagram_profile

Fetch an Instagram creator's public profile snapshot. Returns verified status, real follower and following counts, total post count, and recent content.

Post type is one of video, post (image), or sidecar (carousel). Video posts include a direct video URL you can pass into get_video_transcript.

Platforms supported

YouTube · TikTok · Instagram · X / Twitter · Facebook

Environment variables

Links

• Get an API key
• Full API docs
• npm package