360 Secure SkillHub
360 安全技能中心

Influencer Campaign Monitoring (TikTok/IG/YouTube)

用于在 TikTok、Instagram 和 YouTube 上创建、查询、刷新或停止视频监测任务，获取创作者和视频指标，并输出任务状态、趋势、异常与行动建议。依赖 Python 脚本调用 ScrumBall 接口，需配置网关地址和 API Key。

chengyu-xixihaha
chengyu-xixihaha
热度 20.93
最近更新 2026-08-24 16:32:52
分类：营销依赖：代码执行 / 第三方 API / 读写文件应用场景：社交媒体 / 市场分析 / 报告撰写 / 任务管理

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add influencer-campaign-monitoring
Metadata
name
influencer-campaign-monitoring
description
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.

Influencer Campaign Monitoring

Operate monitoring tasks and convert tracking data into actionable campaign review insights.

Capability Matrix

YouTube

Capability operationId Interface Minimum input
任务-视频下载 youtube_task_video_download GET /api/v1/youtube/task/video/download query.video_id
用户监控指标 youtube_user_monitor_metrics GET /api/v1/youtube/user/monitor/metrics query.channel_id

TikTok

Capability operationId Interface Minimum input
任务-视频下载 tiktok_task_video_download GET /api/v1/tiktok/task/video/download query.video_id
用户监控指标 tiktok_user_monitor_metrics GET /api/v1/tiktok/user/monitor/metrics query.unique_id

Instagram

Capability operationId Interface Minimum input
任务-视频下载 instagram_task_video_download GET /api/v1/instagram/task/video/download query.video_code
用户监控指标 instagram_user_monitor_metrics GET /api/v1/instagram/user/monitor/metrics query.username

Cross-platform

Capability operationId Interface Minimum input
创建视频监测任务 create_monitor_task POST /api/v1/monitor/video/tasks/create body.platform, body.video_id
获取视频监测任务详情 get_monitor_task_detail GET /api/v1/monitor/video/tasks/detail query.monitor_id
获取视频监测任务列表 list_monitor_tasks GET /api/v1/monitor/video/tasks/list none
手动刷新视频监测数据 refresh_monitor_task POST /api/v1/monitor/video/tasks/refresh query.monitor_id
停止视频监测任务 stop_monitor_task GET /api/v1/monitor/video/tasks/stop query.monitor_id

Quick Start

  1. Identify monitoring scope (platform, creator/video, timeframe).
  2. Use Cross-platform matrix rows for task lifecycle operations.
  3. Use platform rows for metrics/download operations.
  4. Report trend, anomalies, and intervention actions.

Workflow

  1. Create or retrieve tasks (create_monitor_task, list_monitor_tasks, get_monitor_task_detail).
  2. Refresh/stop tasks as needed (refresh_monitor_task, stop_monitor_task).
  3. Pull platform metrics and tracked assets for campaign review.
  4. Summarize movement, anomalies, and next-step recommendation.

Tooling

Execution commands:

  • List operations: python3 scripts/execute_operation.py --env-file .env list
  • Create task: python3 scripts/execute_operation.py --env-file .env call --operation create_monitor_task --body '{"platform":"tiktok","video_id":"123456"}'
  • List tasks: python3 scripts/execute_operation.py --env-file .env call --operation list_monitor_tasks --query '{"page":1,"page_size":20}'

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 <skill-root>/.env.

Output Contract

Always return:

  • Task status: active/completed/stopped + identifiers
  • Performance trend: key metric movement
  • Anomalies: unexpected spikes/drops
  • Recommendation: continue, adjust, or stop

Failure Handling

  • If task creation fails, validate platform and video identifier first.
  • If metric endpoints lag, report delayed freshness explicitly.
  • If user asks for audience-fit decisioning, hand off to audience-fit 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.