原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。评价和账户功能将在后续阶段推出。
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚

TrueScrape

作者:TrueScrape版本 0.8.0i★ –i电脑或云端
注册名称io.github.TrueScrape/truescrape

安装

概览

作者提供的说明(英文原文)

Live context for your agent: competitors, mentions and markets, from public data.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

  • 连接方式: 电脑或云端
  • 传输方式: stdio, Streamable HTTP
  • 分类: 其他
  • 你需要填写:TRUESCRAPE_API_KEY, x-api-key

安装

选择你使用的 AI 应用,然后复制设置。

安装之前

标为机密的值是你账户的钥匙。千万不要分享给别人,也不要粘贴到聊天里。

你需要

  • 在云端运行无需安装任何东西,通过互联网连接
  • npm已安装 Node.js(用于 npx 命令)

你用的是哪个应用?

在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。

这个地址需要在请求的 header 中放入密钥,而添加连接器的菜单无法设置。请改用 Claude Code、Cursor 或 VS Code。

或者在你的电脑上运行

打开 Claude Desktop → Settings → Developer → Edit Config,把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "truescrape": {
      "command": "npx",
      "args": [
        "-y",
        "truescrape",
        "mcp"
      ],
      "env": {
        "TRUESCRAPE_API_KEY": "your-value"
      }
    }
  }
}

在终端中运行这条命令

claude mcp add --transport http truescrape https://api.truescrape.com/mcp --header 'x-api-key: your-value'

或者在你的电脑上运行

claude mcp add truescrape --env TRUESCRAPE_API_KEY=your-value -- npx -y truescrape mcp

运行前请先填写空着的值。

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "truescrape": {
      "url": "https://api.truescrape.com/mcp",
      "headers": {
        "x-api-key": "your-value"
      }
    }
  }
}

或者在你的电脑上运行

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "truescrape": {
      "command": "npx",
      "args": [
        "-y",
        "truescrape",
        "mcp"
      ],
      "env": {
        "TRUESCRAPE_API_KEY": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "truescrape": {
      "type": "http",
      "url": "https://api.truescrape.com/mcp",
      "headers": {
        "x-api-key": "your-value"
      }
    }
  }
}

或者在你的电脑上运行

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "truescrape": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "truescrape",
        "mcp"
      ],
      "env": {
        "TRUESCRAPE_API_KEY": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

这个地址需要在请求的 header 中放入密钥,而添加连接器的菜单无法设置。请改用 Claude Code、Cursor 或 VS Code。

你的选择通过 Cookie 保存在这台设备上,无需账户。

需要你填写的值

  • TRUESCRAPE_API_KEY 机密 必填 env
    Your TrueScrape API key from https://truescrape.com/dashboard.
  • x-api-key 机密 必填 HTTP header
    Your TrueScrape API key from https://truescrape.com/dashboard (1,000 free credits on signup).

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。

它能做什么

工具名称和描述与服务器在 2026年11月6日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。

  • amazon_offers

    All seller offers for a product. Every offer on an Amazon listing (price, seller, condition, Prime eligibility and shipping), alongside the product itself. Costs 3 credits.

  • amazon_product

    Product details. Public details for one Amazon listing: title, brand, price, availability, rating, specifications and an inline review sample. Costs 3 credits.

  • amazon_search

    Search results. Public Amazon search results for a query: position, price, rating and badges per item. Costs 3 credits.

  • amazon_shop

    Amazon Shop page. A creator's public Amazon storefront: their name, the product links the page exposes, and the storefront feed of idea lists (with Amazon's own item count), shoppable videos (id, title, thumbnail and attached ASINs) and shoppable photos. The first request needs n

  • appleMusic_album

    Album details. Public Apple Music album: artist, release date, genre, artwork and total runtime. The track listing and copyright line are in `raw`, behind `include_raw=true`. Costs 1 credit.

  • appleMusic_artist

    Artist details. Public Apple Music artist page: editorial bio, artist image, banner and genre. Apple publishes no follower or play counts, so those fields are null rather than guessed. Costs 1 credit.

  • appleMusic_search

    Search. Search the Apple Music catalogue for tracks, albums or artists. Tracks and albums come back as posts; artists come back as creators. Costs 1 credit.

  • appleMusic_track

    Track details. Public Apple Music track: artist, album, duration, genre, release date and the 30-second preview URL. Costs 1 credit.

  • bilibili_video

    Video files and details. A public Bilibili video's mp4 address (up to 720p), description, tags, duration and first frame. For a multi-part video, `?p=` in the URL selects the part. The title, the uploader, the counts and the upload date are null. The mp4 address expires 2 hours a

  • bitchute_channel

    Channel profile. A public BitChute channel: name, description, subscriber count, video count, total views and creation date. Costs 1 credit.

  • bitchute_channelVideos

    Channel videos. A BitChute channel's public videos, newest first, 50 per page, with view counts. Likes and comment counts are not in the list; `bitchute.video` has likes. Pass the `cursor` from the previous response to page. Costs 1 credit.

  • bitchute_search

    Search videos. Public BitChute video search, 50 per page, with view counts and the uploading channel. Costs 1 credit.

  • bitchute_video

    Video details. A public BitChute video: title, description, hashtags, duration, publish date, channel, views and likes. Dislikes are in `raw`. `commentCount` is always null. Costs 1 credit.

  • bluesky_post

    Post. A single public Bluesky post with like, reply, repost and quote counts, plus any attached images or video. Costs 1 credit.

  • bluesky_profile

    Profile. Public profile for a Bluesky account: followers, following, post count, bio, avatar, banner, and verification status. Costs 1 credit.

  • bluesky_search

    Search posts. Public Bluesky posts matching a keyword, newest first. Costs 1 credit.

  • bluesky_userPosts

    User posts. Recent public posts from a Bluesky account, newest first. Reposts are excluded by default so the feed reflects what the account actually wrote. Costs 1 credit.

  • dailymotion_channel

    Channel profile. Public profile of a Dailymotion channel: followers, following, video count, lifetime views, verification badge, country and creation date. Costs 1 credit.

  • dailymotion_channelVideos

    Channel videos. A Dailymotion channel's public uploads, newest first, 50 per page, all the way back to the first upload. Pass the `cursor` from the previous response to page. Costs 1 credit.

  • dailymotion_search

    Search videos. Public Dailymotion video search, 50 per page. Dailymotion returns at most the first 1,000 results for any query, so paging stops there. Costs 1 credit.

  • dailymotion_video

    Video details. Public metadata for a Dailymotion video: views, likes, duration, tags, upload date and channel. Dailymotion has no public comments, so `commentCount` is null. Costs 1 credit.

  • dailymotion_transcript

    Video transcript. A Dailymotion video's captions as one text block plus timed cues. Returns the requested language when the video has it, otherwise the first track. Most are generated automatically by Dailymotion. Costs 1 credit.

  • deezer_album

    Album details. A Deezer album: title, artist, label, UPC, release date, fans (`likeCount`) and its tracks. Pass `cursor` to page the tracks of a long album. Costs 1 credit.

  • deezer_artist

    Artist profile. A Deezer artist: name, fans, album count, picture and link. Costs 1 credit.

  • deezer_artistAlbums

    Artist albums. An artist's albums, singles and EPs on Deezer. `likeCount` is the release's fans. Costs 1 credit.

  • deezer_artistTopTracks

    Artist top tracks. An artist's most popular tracks on Deezer, most popular first. Costs 1 credit.

  • deezer_charts

    Charts. Deezer's global top tracks, albums, artists, playlists or podcasts. Costs 1 credit.

  • deezer_playlist

    Playlist contents. A public Deezer playlist: title, owner, description, cover, track count, fans and its tracks. Pass `cursor` to page the tracks of a long playlist. Costs 1 credit.

  • deezer_podcast

    Podcast details. A Deezer podcast: title, description, artwork and fans. Deezer publishes no episode count, so `postCount` is null. Costs 1 credit.

  • deezer_podcastEpisodes

    Podcast episodes. A Deezer podcast's episodes, newest first. Costs 1 credit.

  • deezer_search

    Search. Search Deezer's catalogue for tracks, albums, artists, playlists or podcasts. Costs 1 credit.

  • deezer_track

    Track details. A Deezer track: title, artist, album artwork, duration, release date, ISRC and tempo. Costs 1 credit.

  • deezer_userPlaylists

    User playlists. A Deezer user's public playlists. Costs 1 credit.

  • inference_ageGender

    Estimate age and gender from an image. Apparent age and gender estimated from a public image URL. This is a model ESTIMATE, not measured platform data, and every response is labelled as such. Requires an inference provider to be configured on the deployment. Costs 1 credit.

  • ebay_product

    eBay listing details. Public details for an eBay listing: title, price, condition, seller and an inline sample of reviews. Costs 1 credit. Pass either `product_id` or `url`.

  • ebay_search

    Search eBay listings. Public eBay search results for a query, with eBay's own filters and sort orders. Costs 1 credit.

  • facebook_ad

    Ad details. One ad from the Meta Ad Library by its archive id. Meta does not expose the archive as an addressable node for every ad; pass `page_id` as well and we find it by scanning that advertiser's archive instead. Costs 1 credit.

  • facebook_adTranscript

    Ad video transcript. Retrieves a transcript for a single Facebook Ad Library video ad by ID or URL, read from the caption track Facebook publishes for the ad's video (`source: "captions"`). Transcription of ad videos without captions is coming soon; until then those answer `not_c

  • facebook_adLibraryAdvertisers

    Find advertisers running ads. Distinct advertisers whose ads match a search term, with the `page_id` needed by /v1/facebook/ad-library/page-ads. Derived from the ads an Ad Library search returns, ranked by how many of them each advertiser ran. Costs 1 credit.

  • facebook_pageAds

    All ads for one advertiser. Ads a specific Facebook page is running or has run, from Meta's Ad Library. This is the competitor-monitoring endpoint. `pagination.cursor` is filled only where the deployment reads the Graph Ad Library API; otherwise `pagination.hasMore` says whether

  • facebook_adLibrarySearch

    Search the Meta Ad Library. Facebook, Instagram, Messenger and Threads ads matching a search term, from Meta's Ad Library, in the Library's own order. Spend and impression ranges are filled for political and issue ads only where the deployment reads the Graph Ad Library API; `pag

  • facebook_cityEvents

    Get the events of a city. Public events Facebook is suggesting for a city, from its Events Explore feed (e.g. https://www.facebook.com/events/explore/saint-petersburg-florida/111326725552547). `time` narrows the window to today, this week, or next week; without it Facebook return

  • facebook_commentReplies

    Replies to a comment. Replies under one comment on a public Facebook post, ten per page. Pass the post URL and the comment id (the `id` of any item from /v1/facebook/post-comments), then `pagination.cursor` for the next page. Costs 1 credit.

  • facebook_event

    Event details. Full details for one public Facebook event: description, start and end time, venue with coordinates, host and ticket price range. Costs 1 credit.

  • facebook_eventsSearch

    Search public events. Public Facebook events matching a search term. Results are ranked and biased toward where Facebook places the request, so the same query can return a different set on another call. Treat this as discovery, not as an enumerable list. Costs 1 credit.

  • facebook_group

    Public group info. Name, member count, privacy setting and description for a public Facebook group. Member count lands in `followerCount` (a group's equivalent of an audience size) and the privacy setting in `category`. Facebook rounds that count on large groups ("12K members");

  • facebook_groupPosts

    Public group posts. Recent posts from a public Facebook group, with reaction, comment and share counts where Facebook renders them. Only the newest few stories render to a logged-out visitor, the same limit /v1/facebook/page-posts has. Private groups return an empty result; their

  • facebook_marketplaceItem

    Marketplace listing details. One public Facebook Marketplace listing: title, full description, price, location, delivery options and every photo. Facebook does not render the seller to a logged-out visitor, so seller identity is not returned. Costs 1 credit.

  • facebook_marketplaceLocations

    Find a Marketplace location. Resolve a place name to the Marketplace location ids /v1/facebook/marketplace/search accepts, plus the neighbouring locations Facebook offers around it. Marketplace is city-scoped, so this is how you search a city you are not sitting in. Costs 1 credi

  • facebook_marketplaceSearch

    Search Marketplace listings. Public Facebook Marketplace listings matching a search term, with price, condition flags, location and photos. `location` takes a city slug or a location id from /v1/facebook/marketplace/locations; without one, Facebook picks the city it places the re

  • facebook_pagePosts

    Public Page posts. Recent public posts from a Facebook Page, newest first, three per page, with text, reaction, comment and share counts, and the publish timestamp. Pass `pagination.cursor` back for the next three. Costs 1 credit.

  • facebook_pageReels

    Public Page videos and reels. Public videos and reels from a Facebook Page. Reads the Page's reels tab first, ten per page with `pagination.cursor` for the next ten, and falls back to its video grid, which renders around twenty entries with titles, view counts and durations and h

  • facebook_post

    Single post, video, or reel. One public Facebook post, video or reel by URL, with its text and engagement counts. Costs 1 credit.

  • facebook_postComments

    Comments on a post. Top-level comments on a public Facebook post, with author, reaction count and reply count, in Facebook's "Most relevant" order. The first page is the head of the thread Facebook renders into the post, usually two comments; pass `pagination.cursor` back for the

  • facebook_postTranscript

    Video transcript. Transcript for a public Facebook video or reel, as one text block plus timed cues. Reads the caption track Facebook publishes for the video, auto-generated when the uploader added none (`source: "captions"`). Transcription of videos without captions is coming so

  • facebook_profile

    Public Page profile. Name, category, follower and like counts, description, banner and outbound links for a public Facebook Page. `followerCount` is as precise as Facebook renders it: exact on a small Page ("498 followers"), rounded on a large one ("28M followers", so ±500,000).

  • facebook_profileEvents

    Events on a Page. Events hosted by a public Facebook Page, upcoming ones first, with past events where Facebook still lists them, eight per page; pass `pagination.cursor` back for the next eight. Each carries start time, place, host and the cover photo. Costs 1 credit.

  • facebook_profilePhotos

    Photos on a Page. Photos from a public Facebook Page's photo grid, eight per page, newest first; pass `pagination.cursor` back for the next eight. Facebook exposes each photo's accessibility caption rather than the text of the post it came from, so that is what lands in `title`.

  • identity_findSocialProfiles

    Find a creator's other social profiles. Starts from one public profile and reports the other accounts that profile can be shown to own: profiles it links to directly, profiles reached through a recognised link-in-bio page (Linktree, Komi, Pillar, Lnk.Bio, LinkMe), and same-handle

  • flickr_post

    Photo or video details. A public Flickr photo or video: title, description, owner, views, faves, comments, upload date and media addresses. A video lists one signed MP4 per encode, best first, and those links expire within minutes, so fetch them straight away. A photo lists its l

基础检查i

我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月6日

  • ✓ 通过

    作者与仓库一致

    注册名称已通过 GitHub 账户 TrueScrape 验证,该账户拥有此仓库

  • … 尚未检查

    仍在维护

    我们还没有从 GitHub 读取这个仓库

  • … 尚未检查

    有许可证

    我们还没有从 GitHub 读取这个仓库

  • ✓ 通过

    端点有响应

    在 562 毫秒内响应(HTTP 200)

  • – 不适用

    使用 OAuth 登录

    无需登录

  • ✓ 通过

    工具描述中没有隐藏指令

    已读取 60 个工具描述,未发现针对 AI 的隐藏指令

与“其他”中的其他服务器比较i

  • 星标数多于此分类中其他 32435 个服务器的 0%
  • 发布到注册中心的时间比此分类中其他 32435 个服务器的 93% 更新
  • 基础检查结果等于或优于此分类中其他 32435 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。

常见问题

TrueScrape 安全吗?

它在 3 项适用的基础检查中通过了 3 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。

它需要哪些密钥或代码?

你需要填写:TRUESCRAPE_API_KEY, x-api-key

它在我的电脑上运行还是在云端?

两种方式都可以:安装在你的电脑上,或者连接云端版本。

它还在维护吗?

GitHub 仓库最后更新于–,最新版本(0.8.0)于前天进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,所以接受远程 MCP 服务器的应用也可以使用,例如开启开发者模式的 ChatGPT。

有什么可以替代它?

同一分类中有:Spec Driven Development, Remote Desktop Commander, Apify MCP Server

替代选择

同一分类中其他作者的服务器,按星标数排序。

如何看卡片:★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Spec Driven Development

作者:formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

在你的电脑上运行★ 440MIT14个月前更新
安装

Remote Desktop Commander

作者:desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

在云端运行★ 211昨天更新
安装

Apify MCP Server

作者:apify

Extract data from any website with thousands of scrapers, crawlers, and automations on Apify Store ⚡

在云端运行今天更新
安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

TrueScrape

Live context for your agent: competitors, mentions and markets. An agent can read your code and files. It cannot see your competitors, your market, or what people say about you. Connect it in one line:

npx truescrape auth login                # once: stores your key from truescrape.com/dashboard

npx truescrape agent add claude-code # or: claude-desktop, cursor, vscode

Then ask it for one of three jobs:

JobAsk your agentWhat it uses
Research on demand"What are people saying about standing desks, and what do they cost on Amazon and Walmart?"Search and profile tools across social platforms, plus Amazon and Walmart search
Watch competitors and accounts"Watch Acme's YouTube channel and tell me what's new"A monitor on their accounts. No webhook needed, and it checks when your agent asks
Find mentions"Who is mentioning Acme, and what needs a reply?"One search across public sources, each reporting what it found or that it could not be checked

Public, logged-out data only. Monitors check on request, or on a schedule of an hour or longer.

  • 1,000 free credits on signup, no card. Most requests cost 1 credit.
  • Failed and empty requests are never charged, and cache hits cost 0.
  • Credits never expire. No subscription; packs from $25 for 20,000 credits.

It all works without an agent too, from the terminal or your own scripts:

$ truescrape instagram profile --handle natgeo --pretty

{ "platform": "instagram", "id": "787132", "handle": "natgeo", "displayName": "National Geographic", … "verified": true, "followerCount": 268245801, "followingCount": 195, "postCount": 32000, … } 1 credit · live fetch · 1204 ms · req_…

This repository holds the three ways to plug it into your tools and your agents.

InstallBest for
CLInpm install -g truescrape or npx truescrape …Scripts, cron, CI, one-off pulls, piping into jq
MCP serverclaude mcp add --transport http truescrape https://api.truescrape.com/mcp --header "x-api-key: YOUR_KEY"Claude, Cursor, VS Code and any MCP client calling endpoints as tools
Agent skillnpx skills add TrueScrape/truescrapeTeaching Claude Code, Cursor, Codex, Copilot, Gemini CLI or Windsurf how to use the API well

259 endpoints across 52 platforms, generated from the live API on 2026-11-04.

tiktok (28) · facebook (22) · instagram (19) · youtube (17) · deezer (11) · github (10) · reddit (9) · google (8) · linkedin (8) · mixcloud (8) · peertube (7) · spotify (7) · twitter (6) · dailymotion (5) · odysee (5) · rumble (5) · substack (5) · threads (5) · amazon (4) · apple-music (4) · bitchute (4) · bluesky (4) · mastodon (4) · pinterest (4) · redfin (4) · twitch (4) · walmart (4) · kwai (3) · snapchat (3) · soundcloud (3) · telegram (3) · truthsocial (3) · zillow (3) · ebay (2) · bilibili (1) · flickr (1) · hackernews (1) · identity (1) · inference (1) · kick (1) · komi (1) · linkbio (1) · linkme (1) · linktree (1) · mashable (1) · milkshake (1) · okru (1) · pillar (1) · solo (1) · streamable (1) · taplink (1) · vimeo (1)

Get a key at truescrape.com/dashboard. Docs: truescrape.com/docs · OpenAPI · llms.txt

Three rules that change how you plan

  1. Failed requests and empty results are never charged. Just call it.
  2. Cache hits cost 0 credits. Pass --cache-max-age 7d (or cache_max_age=7d) whenever real-time data is not required.
  3. Many targets means one batch, not a loop. Up to 500 targets per job.

CLI

npm install -g truescrape          # or: npx truescrape <command>

truescrape auth login # stores your key (0600) after checking it truescrape list # platforms truescrape list youtube # endpoints for one platform truescrape youtube channel --handle @mkbhd truescrape youtube channel-videos --handle @mkbhd --all | jq '.items[].viewCount' truescrape youtube channel --handle @mkbhd --cache-max-age 24h --format table truescrape batch youtube transcript --targets ids.json --wait truescrape download https://x.com/ /status/ --out ./videos truescrape balance

Mentions and monitors
truescrape mentions find "Acme"                 # one search, nothing stored

truescrape monitors create "Acme" --manual # keep watching; checks only when you say truescrape monitors create "Acme" --no-search --accounts youtube:@acme,bluesky:acme.com --manual truescrape monitors create "Acme" --interval 21600 --stop-at --max-credits truescrape monitors check # check each source now, report what is new truescrape monitors updates --unread # read what this key has not read truescrape monitors updates --platform reddit --source mention --since 7d truescrape monitors list truescrape monitors delete

Each takes --json, and exits 1 on an API error. Creating and reading are free. mentions find costs 1 credit per source that answers. A check charges each source that answers at its endpoint's own price; creditsPerCheck in the create response is the most one check can charge, and the first check is a baseline that reports nothing as new. Failed, empty and cached answers are free, and the output names each source that could not be checked, so a failure never reads as "no mentions".

Mention sources: Reddit, Hacker News, Bluesky, YouTube, Threads, Instagram tags, TikTok tags, Dailymotion, PeerTube and Odysee. PeerTube and Odysee have no date order and may rarely surface new videos. X, LinkedIn search and Instagram captions are not covered.

Accounts can be followed on YouTube, TikTok, Instagram, Threads, Bluesky, Reddit, Mastodon (the handle includes the server), Telegram, Substack and LinkedIn. X and Facebook accounts are not available.

An agent creating a monitor passes --agent , so you can see what it left running. A scheduled monitor runs until deleted unless you set --stop-at or --max-credits.

truescrape download [--out ] [--force] [--json] saves the video from a public Instagram, Facebook, X, Streamable, Mashable, Flickr or Bilibili post. The lookup costs 1 credit and nothing if it fails; the file comes straight from the platform's own video servers, checked to be https, unredirected, a video, and under 150 MB. YouTube, Vimeo and OK.ru links are refused: they offer no plain file a CLI can fetch. Only download videos you made or have permission to use.

Every endpoint is truescrape --param value. Run any command with --help for its parameters, cost and any cross-field rule.

Authentication, in order of precedence: --api-key for one request (visible in shell history; avoid for anything persistent), the TRUESCRAPE_API_KEY environment variable (use this in CI and for agents), then the key stored by truescrape auth login.

Output. Data goes to stdout as compact JSON; the billing line (1 credit · live fetch · 412 ms · req_…) goes to stderr, so pipes stay clean.

FlagEffect
`--format json\table\csv\markdown`Output format (default json)
--prettyIndented JSON
--envelopePrint { data, meta, pagination } instead of data
--output Write to a file and print only its path
--all, --max-pages Follow the cursor and merge pages (default cap 10)
--quietNo billing line
--verboseRequest URL, status and timing on stderr
--base-url Another API origin (also TRUESCRAPE_BASE_URL)

Exit codes: 0 success · 1 the API returned an error · 2 usage or configuration error · 3 the API could not be reached. When stderr is not a terminal, errors are one JSON line in the API's own shape, with the request id from the response header beside it: {"success":false,"error":{"code":"invalid_api_key","message":"…"},"requestId":"req_…"}. A 401 is always a key problem and a 402 always a balance problem; the CLI never conflates them.

MCP server

The API serves a remote MCP server at https://api.truescrape.com/mcp. Every endpoint is a tool; every call goes through the same billing rules as HTTP.

# Claude Code

claude mcp add --transport http truescrape https://api.truescrape.com/mcp \ --header "x-api-key: YOUR_KEY" --scope user

Or let the CLI write the config for you

truescrape agent add claude-code truescrape agent add cursor # ~/.cursor/mcp.json (--project for .cursor/mcp.json) truescrape agent add vscode # .vscode/mcp.json truescrape agent add claude-desktop # claude_desktop_config.json, via the stdio bridge below

Cursor and VS Code, by hand:

{ "mcpServers": { "truescrape": { "url": "https://api.truescrape.com/mcp", "headers": { "x-api-key": "YOUR_KEY" } } } }
{ "servers": { "truescrape": { "type": "http", "url": "https://api.truescrape.com/mcp", "headers": { "x-api-key": "YOUR_KEY" } } } }

Clients that can only launch a local process get the same server through the bridge, which forwards stdio to the remote endpoint with your stored key:

{ "mcpServers": { "truescrape": { "command": "npx", "args": ["-y", "truescrape", "mcp"], "env": { "TRUESCRAPE_API_KEY": "YOUR_KEY" } } } }

`agent add` installs a default toolset, not every tool, which leaves the agent room to work: youtube, tiktok, instagram, reddit, threads, bluesky, hackernews, amazon and walmart. From the agent, explore_tools finds any other tool and call_tool runs it. Change the set by adding the client again; a config you already have stays as it is until you do:

truescrape agent add cursor --platforms youtube,instagram    # only these

truescrape agent add cursor --all # every tool

A URL you write by hand loads every tool unless you add ?platforms=:

claude mcp add --transport http truescrape "https://api.truescrape.com/mcp?platforms=youtube,instagram" \

--header "x-api-key: YOUR_KEY" --scope user

Tools can be listed without a key, so you can inspect them before signing up; calling one needs the key.

The server advertises its URL, transport and auth header at https://api.truescrape.com/.well-known/mcp; agent add reads that rather than assuming.

Agent skills

truescrape teaches an agent endpoint selection, the cost model, batching, mentions, monitors, subscriptions and the platform quirks worth knowing, with the full endpoint table generated from the live API. Workflow skills build on it:

SkillWhat it does
competitor-watchFollows a competitor's accounts and reports what changed since last time
mention-digestPublic mentions grouped by source, each with its link, flagging what needs a reply
market-scanA question about a category, across social posts and Amazon and Walmart search

| video-to-content-brief | Turns a sample of YouTube videos into a source-linked brief

只显示了开头部分;其余内容请在仓库中阅读

问 PopNx