Agent Skills › gooseworks-ai/goose-skills › scrapecreators-api

scrapecreators-api

GitHub

提供从主流社交平台及广告库结构化采集公开数据的能力,支持Instagram、TikTok、YouTube等。作为研究工作流的依赖项,通过MCP或CLI调用,不直接面向最终用户交付。

skills/shared/scrapecreators-api/SKILL.md gooseworks-ai/goose-skills

触发场景

需要大规模采集社交媒体公开资料 获取视频转录、评论或广告库数据

安装

npx skills add gooseworks-ai/goose-skills --skill scrapecreators-api -g -y
更多选项

非标准路径

npx skills add https://github.com/gooseworks-ai/goose-skills/tree/main/skills/shared/scrapecreators-api -g -y

不安装直接使用

npx skills use gooseworks-ai/goose-skills@scrapecreators-api

指定 Agent (Claude Code)

npx skills add gooseworks-ai/goose-skills --skill scrapecreators-api -a claude-code -g -y

安装 repo 全部 skill

npx skills add gooseworks-ai/goose-skills --all -g -y

预览 repo 内 skill

npx skills add gooseworks-ai/goose-skills --list

SKILL.md

Frontmatter
{
    "name": "scrapecreators-api",
    "description": "Provider reference for collecting public profiles, posts, comments, transcripts, trends, and ad-library data from major social platforms through ScrapeCreators. Use as a dependency of research workflows, not as the final user-facing deliverable."
}

ScrapeCreators API

Use ScrapeCreators when a workflow needs structured public social or ad-library data at a scale that ordinary web search cannot provide.

Runtime selection

Task skills describe each request as an environment-neutral operation containing provider, method, path, and optional query or body. Execute that same operation through the first available runtime:

  1. GooseWorks MCP available: inspect and call the live data_call_provider tool. Pass the operation fields directly. This is the preferred path in ChatGPT, Cowork, and any client without a terminal. It uses the first-party GooseWorks ScrapeCreators proxy and managed key; it does not route through Orthogonal.
  2. Local GooseWorks CLI available: translate the operation into gooseworks call <provider> <path>, adding the method, query, or body options represented in the operation. The CLI uses the same first-party proxy.
  3. User-owned ScrapeCreators key available: call https://api.scrapecreators.com<path> with SCRAPECREATORS_API_KEY in the x-api-key header, using the operation's method, query, and JSON body.
  4. No runtime available: ask the user to connect GooseWorks MCP, sign in through the local GooseWorks CLI, or provide their own ScrapeCreators key. Do not pretend the operation ran.

Prefer MCP whenever data_call_provider is registered, even if a shell might also exist. Never ask for a separate provider key when the managed MCP or CLI path is available. Never print, store, or return either credential.

Example operation:

provider: scrapecreators
method: GET
path: /v1/instagram/profile
query:
  handle: brand

Use ScrapeCreators' official OpenAPI as the endpoint source of truth: https://docs.scrapecreators.com/openapi.json. Do not use Orthogonal search or details to discover ScrapeCreators operations because its mirrored catalog can be incomplete.

Endpoint families

Need Common endpoint
Instagram profile, posts, or comments /v1/instagram/profile, /v2/instagram/user/posts, /v1/instagram/post, /v2/instagram/post/comments
TikTok profile, posts, search, trends /v1/tiktok/profile, /v3/tiktok/profile/videos, /v2/tiktok/video, /v1/tiktok/search/hashtag, /v1/tiktok/get-trending-feed
YouTube video, channel, transcript, comments /v1/youtube/video, /v1/youtube/channel, /v1/youtube/video/transcript, /v1/youtube/video/comments
X profile, posts, or post details /v1/twitter/profile, /v1/twitter/user-tweets, /v1/twitter/tweet
LinkedIn profile, company, posts, or ads /v1/linkedin/profile, /v1/linkedin/company, /v1/linkedin/post, /v1/linkedin/ads/search
Meta Ad Library /v1/facebook/adLibrary/search/ads, /v1/facebook/adLibrary/ad
TikTok Ad Library Resolve the current search and ad-detail operations from the official OpenAPI
Google advertiser ads /v1/google/company/ads, /v1/google/ad
TikTok Shop products, reviews, and creator showcases Resolve the current shop search, product, review, and user-showcase operations from the official OpenAPI
Instagram and YouTube discovery Resolve current Reel, audio, Shorts, hashtag, search, and trend operations from the official OpenAPI
Reddit, Threads, Bluesky, and Pinterest research Resolve current search, profile, post, comment, board, and pin operations from the official OpenAPI
Public creator links and shops Resolve current Linktree, Komi, Pillar, Linkbio, Linkme, and Amazon Shop operations from the official OpenAPI

Most operations are GET requests. ScrapeCreators' official OpenAPI currently also defines POST variants for Meta ad search, Meta company ads, and Reddit post comments. Use POST only when the official operation requires it:

provider: scrapecreators
method: POST
path: /v1/facebook/adLibrary/search/ads
body:
  query: running shoes
  country: US

Endpoint names can change. If a request fails or the exact parameters are unclear, read https://docs.scrapecreators.com/openapi.json before guessing.

Collection rules

  1. Confirm platform, market, time window, and sample size.
  2. Start with a small request and inspect the response shape.
  3. Follow the returned cursor until the requested sample is reached or no cursor remains.
  4. Keep the raw source URL, creator handle, platform, publication date, and engagement fields with every item.
  5. Deduplicate by platform-native content ID or canonical URL.
  6. Separate facts returned by the API from conclusions inferred during analysis.
  7. Do not use follower count as a proxy for audience fit or post quality.

Output contract

Provider calls should return a normalized source set for the parent workflow:

{
  "platform": "instagram",
  "query": "brand",
  "collected_at": "ISO-8601",
  "items": [{"id":"...","url":"...","author":"...","published_at":"...","text":"...","metrics":{}}],
  "next_cursor": null,
  "limitations": []
}

This is a provider skill. Do not stop after dumping API output; return control to the research skill that requested the data.

版本历史

  • 1add09b 当前 2026-11-02 21:54

同 Skill 集合

docs/skill-template/SKILL.md
skills/entry/goose-ads/SKILL.md
skills/entry/goose-product-photos/SKILL.md
skills/entry/goose-video/SKILL.md
skills/entry/gooseworks/SKILL.md
skills/entry/make-custom-video/SKILL.md
skills/marketing/analyze-performance-call-and-learn/SKILL.md
skills/marketing/analyze-performance-diagnose/SKILL.md
skills/marketing/analyze-performance-intake/SKILL.md
skills/marketing/analyze-performance-rank-and-read/SKILL.md
skills/marketing/analyze-performance-revenue-join/SKILL.md
skills/marketing/claims-gate/SKILL.md
skills/marketing/email-lifecycle-broadcast-planner/SKILL.md
skills/marketing/email-lifecycle-flow-writer/SKILL.md
skills/marketing/email-lifecycle-lifecycle-audit/SKILL.md
skills/marketing/email-lifecycle-offer-math/SKILL.md
skills/marketing/email-lifecycle-send-check/SKILL.md
skills/marketing/honest-review/SKILL.md
skills/marketing/improve-search-visibility-citation-check/SKILL.md
skills/marketing/improve-search-visibility-entity-footprint/SKILL.md
skills/marketing/improve-search-visibility-fix-writer/SKILL.md
skills/marketing/improve-search-visibility-page-and-foundation-check/SKILL.md
skills/marketing/improve-search-visibility-question-set/SKILL.md
skills/marketing/improve-search-visibility-store-listing-audit/SKILL.md
skills/marketing/make-content-content-brief/SKILL.md
skills/marketing/make-content-source-to-units/SKILL.md
skills/marketing/make-content-two-pass-edit/SKILL.md
skills/marketing/make-static-ads-ad-copy/SKILL.md
skills/marketing/make-static-ads-claims-extract/SKILL.md
skills/marketing/make-static-ads-compose/SKILL.md
skills/marketing/make-static-ads-concept-grid/SKILL.md
skills/marketing/make-static-ads-copy-variants/SKILL.md
skills/marketing/make-static-ads-find-references/SKILL.md
skills/marketing/make-static-ads-fix-rejected/SKILL.md
skills/marketing/make-static-ads-graphic-request/SKILL.md
skills/marketing/make-static-ads-render-review/SKILL.md
skills/marketing/marketing-guide/SKILL.md
skills/marketing/outcomes-ledger/SKILL.md
skills/marketing/plan-campaign-brief-and-assets/SKILL.md
skills/marketing/plan-campaign-budget-and-tests/SKILL.md
skills/marketing/plan-campaign-channel-decision/SKILL.md
skills/marketing/plan-campaign-goal-chain/SKILL.md
skills/marketing/research-audience-account-sourcing/SKILL.md
skills/marketing/research-audience-fit-definition/SKILL.md
skills/marketing/research-audience-people-and-contacts/SKILL.md
skills/marketing/research-audience-score-segment-qa/SKILL.md
skills/marketing/research-audience-segment-pass/SKILL.md
skills/marketing/research-audience-signals-and-hooks/SKILL.md
skills/marketing/research-competitors-category-pass/SKILL.md
skills/marketing/research-competitors-edge-cases/SKILL.md

元信息

文件数
0
版本
1add09b
Hash
1c2b8ed2
收录时间
2026-11-02 21:54

首页 - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-18 19:55
浙ICP备14020137号-1