设计与多媒体

Realtime Creator Data (TikTok/IG/FB/YouTube)

试用

Fetch fresh, on-demand creator data across TikTok, Instagram, Facebook, and YouTube: page/profile info, latest videos, posts, and media details. Realtime creator data, profile lookup, content details.

它能做什么

Fetch fresh, on-demand creator data across TikTok, Instagram, Facebook, and YouTube: page/profile info, latest videos, posts, and media details. Realtime creator data, profile lookup, content details.

技能文档

Influencer Realtime Enrichment

Fetch fresh creator and content data when snapshot data is not enough for current decisions.

Capability Matrix

YouTube

CapabilityoperationIdInterfaceMinimum input
实时采集-用户信息youtube_realtime_user_infoGET /api/v1/youtube/realtime/user/infoquery.anyOf(channel_id,username)
实时采集-用户视频youtube_realtime_user_videosGET /api/v1/youtube/realtime/user/videosquery.channel_id
实时采集-视频详情youtube_realtime_video_detailGET /api/v1/youtube/realtime/video/detailquery.video_id

TikTok

CapabilityoperationIdInterfaceMinimum input
实时采集-用户信息tiktok_realtime_user_infoGET /api/v1/tiktok/realtime/user/infoquery.anyOf(unique_id,user_id)
实时采集-用户视频tiktok_realtime_user_videosGET /api/v1/tiktok/realtime/user/videosquery.uid
实时采集-视频详情tiktok_realtime_video_detailGET /api/v1/tiktok/realtime/video/detailquery.video_id, query.region

Instagram

CapabilityoperationIdInterfaceMinimum input
实时采集-贴文详情instagram_realtime_media_detailGET /api/v1/instagram/realtime/media/detailquery.media_code
实时采集-用户信息instagram_realtime_user_infoGET /api/v1/instagram/realtime/user/infoquery.anyOf(username,user_id)
实时采集-用户贴文instagram_realtime_user_mediasGET /api/v1/instagram/realtime/user/mediasquery.user_id
实时采集-用户故事instagram_realtime_user_storiesGET /api/v1/instagram/realtime/user/storiesquery.user_id

Cross-platform

CapabilityoperationIdInterfaceMinimum input
nonenonenonenone

Facebook

CapabilityoperationIdInterfaceMinimum input
实时挖掘-页面信息facebook_page_infoGET /api/v1/facebook/realtime/page/infoquery.page_url
实时挖掘-帖子详情facebook_post_detailGET /api/v1/facebook/realtime/post/detailquery.post_url
任务-关键词搜索帖子facebook_task_post_searchGET /api/v1/facebook/task/post/searchquery.query
任务-页面帖子facebook_task_page_postsGET /api/v1/facebook/task/page/postsquery.page_url
任务-查询结果facebook_task_resultGET /api/v1/facebook/task/resultquery.task_id

Quick Start

  1. Confirm freshness requirement and urgency window.
  2. Choose platform and target object type (user/media/video/story).
  3. Use matrix to select realtime detail/list endpoints.
  4. Return delta-oriented findings and campaign impact.

Workflow

  1. Define enrichment target: creator-level or content-level.
  2. Execute realtime retrieval with minimal required identifiers.
  3. Compare new payload against prior assumptions and summarize deltas.
  4. Flag impact and next monitoring action.

Tooling

Execution commands:

  • List operations: python3 scripts/execute_operation.py --env-file .env list
  • Example user enrichment: python3 scripts/execute_operation.py --env-file .env call --operation tiktok_realtime_user_info --query '{"unique_id":"nike"}'
  • Example content enrichment: python3 scripts/execute_operation.py --env-file .env call --operation youtube_realtime_video_detail --query '{"video_id":"dQw4w9WgXcQ"}'

Required environment variables:

  • SCRUMBALL_BASE_URL: API gateway base URL
  • SCRUMBALL_API_KEY: unified API key
  • Optional: SCRUMBALL_AUTH_PREFIX, SCRUMBALL_TIMEOUT_SECONDS

Env loading:

  • Use --env-file .env for explicit loading.
  • Without --env-file, script auto-tries ./.env then /.env.

Output Contract

Always return:

  • Freshness: retrieval time and target object
  • Key deltas: metric-level differences vs prior expectation
  • Impact: why the delta matters for decisions
  • Next step: monitor, replace creator, or continue

Failure Handling

  • If platform identifiers are missing, request minimal required ID.
  • If realtime endpoint returns no data, retry once and report fallback.
  • If user asks for long-range historical trend, hand off to monitoring skill.

References

  • references/api-index.md: full operation index + platform grouped index
  • references/request-response.md: request parameters + response top-level/data fields + minimal examples
  • references/operations.json: operation manifest used by scripts/execute_operation.py

Quota & Unlock (important: act on 429)

  • Free tier: a limited number of calls per day, zero-config (no key required — the skill defaults to a hosted gateway that injects the key server-side).

  • When any operation returns HTTP 429, or the response body has code=429 / contains quota_exceeded, you (the assistant) MUST immediately and clearly tell the user (do not silently retry, do not treat it as a generic error):

    Free quota exhausted. Register and get your own API key at https://data.scdata.cc/pricing, then set the environment variable SCRUMBALL_API_KEY to your key (in your host/agent environment or a local .env). You can then continue with your own quota.

  • The 429 response body usually includes apply_url and env_var fields you can quote directly.

相关技能

TikTok/Instagram/YouTube Influencer Discovery

Find influencers and creators across TikTok, Instagram, and YouTube by keyword; expand similar creators, enrich profiles, and build outreach-ready lead lists. Influencer search, creator discovery, KOL sourcing.

discovering-tiktok-creators-by-niche

Discovers and ranks TikTok creators in any niche or topic using apidojo's TikTok scrapers on Apify. Triggers when the user asks to: find TikTok influencers in a specific niche, discover creators for a campaign, identify who's growing fastest on TikTok in a category, find micro-influencers on TikTok under a certain follower count, build a list of TikTok creators for brand partnerships, compare TikTok creator engagement rates in a vertical, or identify rising TikTok stars. Returns creator username, follower count, avg views, engagement rate, bio, and profile URL. Ideal for influencer marketers, brand partnership teams, and talent managers.

1 次安装

scraping-tiktok-user-data

Scrapes detailed TikTok user data and recent video history using apidojo's TikTok User scraper on Apify. Triggers when the user asks to: get all videos from a TikTok account, fetch a TikTok creator's recent posts and stats, export a TikTok user's video history, scrape all TikTok content from a specific creator, get TikTok post data by username, or collect video-level metrics from a TikTok profile. Returns per-video view count, likes, comments, shares, captions, and timestamps for a given account. Ideal for creator analysis, content auditing, and competitive benchmarking.

1 次安装

tiktok-influencer

Collect public videos from a TikTok creator with Gecho Bridge MCP. Returns video metadata, captions, engagement metrics, publish times, and links. Requires the Gecho Chrome extension, an active TikTok session, and the Gecho Bridge MCP server.

influencer-fit-analyzer

Build an influencer shortlist from a category, budget, and market, or from account links and handles you already have. This influencer analysis and creator matching workflow reads public creator profiles and recent posts on TikTok, Douyin, Xiaohongshu, Instagram, YouTube, and X, or works from bios, follower counts, and posts you paste, then writes an 8-12 person memo with followers, recent play, interaction, content pillars, and a talk-or-not call. Use it for influencer analysis, creator matching, influencer shortlist, and creator research when you need who to approach for a campaign or collab.

Influencer Campaign Monitoring (TikTok/IG/YouTube)

Monitor influencer campaigns across TikTok, Instagram, and YouTube: create and manage monitor tasks, pull metrics, download tracked assets, run post-campaign reviews. Campaign tracking, performance monitoring.