프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. 리뷰와 계정 기능은 다음 단계에서 열려요.
PopNx MCPAI를 쓰는 사람을 위한 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 앱을 고른 다음 설정을 복사하세요.

설치하기 전에

비밀로 표시된 값은 내 계정의 열쇠예요. 절대 다른 사람과 공유하거나 채팅에 붙여 넣지 마세요.

필요한 것

어떤 앱을 쓰세요?

위에서 앱을 고르세요. 기억해 두었다가 다음부터는 버튼에 “…에 설치”라고 표시해요.

이 주소는 요청 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를 쓰세요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

직접 입력할 값

  • 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에서 이 저장소를 읽어 오지 않았어요

  • ✓ 통과

    엔드포인트 응답

    562ms 만에 응답(HTTP 200)

  • – 해당 없음

    OAuth로 로그인

    로그인 필요 없음

  • ✓ 통과

    도구 설명에 숨겨진 지시 없음

    도구 설명 60개를 읽었고, AI에게 보내는 숨겨진 지시는 없었어요

기타 카테고리의 다른 서버와 비교i

  • 이 카테고리의 다른 서버 32403개 중 0%보다 스타가 많아요
  • 이 카테고리의 다른 서버 32403개 중 93%보다 최근에 레지스트리에 공개됐어요
  • 기본 점검 결과가 이 카테고리의 다른 서버 32403개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

TrueScrape, 안전한가요?

해당하는 기본 점검 3개 중 3개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

입력해야 할 값: TRUESCRAPE_API_KEY, x-api-key

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

둘 다 가능해요. 내 컴퓨터에 설치해도 되고, 클라우드 버전에 연결해도 돼요.

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(0.8.0)은 그저께 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. URL로 연결되기 때문에, 원격 MCP 서버를 지원하는 앱(예: 개발자 모드의 ChatGPT)에서도 쓸 수 있어요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Spec Driven Development, Remote Desktop Commander, LickityClick

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:★ 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어제 업데이트
설치

LickityClick

제작자: lickity.click

Create, edit and track LickityClick short links, campaigns and click stats from your AI assistant.

컴퓨터 또는 클라우드오늘 업데이트
설치

제작자의 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에게 묻기