{
"$schema": "../../oss/scenecast/schemas/scene-blueprint-v1.json",
"version": 1,
"id": "scn_kol_tracker",
"slug": "kol-tracker",
"name": "KOL Tracker",
"icon": "person.3.sequence",
"tint": "#EC4899",
"settings": {
"description": "Track any roster of creators across Instagram, TikTok, Facebook and X: the influencers a brand works with, the accounts an agency manages, the voices a newsroom follows. Every hour the agent pulls their new posts, once a day it snapshots follower counts, and a dashboard shows who is growing, who posted, and which posts mention you. The roster is a table in the scene: add a row and the next poll picks it up.",
"cost": "Metered on your plan, per run. A roster of 200 creators on three platforms, polled hourly with a daily follower snapshot, is about $155 a month. A quiet hour returns nothing and costs nothing."
},
"inputs": {
"brand_handles": {
"type": "string",
"required": false,
"description": "The accounts you want mentions of, comma-separated: your brand, your products, a campaign hashtag. Posts by roster creators that mention any of them are flagged on the dashboard."
}
},
"assets": [
{
"id": "intro",
"type": "daslab/note",
"name": "About this tracker",
"fields": {
"content": "# KOL Tracker\n\nEvery hour the agent reads the **Roster** below, pulls every new post from each account on Instagram, TikTok, Facebook and X, and updates the **Dashboard**. Once a day it snapshots follower counts, so the dashboard shows who is growing, who posted, and which posts mention your own accounts.\n\n## How it works\n\n- **Roster** is a table you edit: one row per creator, one column per platform. Leave a cell empty if they are not on that platform.\n- **Hourly poll** asks each platform only for posts newer than two hours. A quiet hour returns nothing and costs nothing.\n- **Daily snapshot** records follower counts per platform, so the dashboard can show seven-day change.\n- **Dashboard** is a view: the leaderboard, the last 48 hours of posts by engagement, and posts that mention `${inputs.brand_handles}`, whether that is your brand, a product, or a campaign hashtag.\n- **Run log** gets one line per run with what was found and what it cost.\n\n## What it costs\n\nRuns are metered on this scene's plan. A roster of 200 creators across three platforms, polled hourly with a daily snapshot, is about $155 a month.\n\n## Try\n\n- *\"Poll now.\"*\n- *\"Add Nike: instagram nike, tiktok nike, x nike.\"*\n- *\"Who grew the most this week?\"*\n- *\"Show me every post that mentioned us in the last 14 days.\"*\n- *\"Which creators went quiet this month?\"*\n"
},
"layout": {
"sortOrder": 0,
"size": "medium"
}
},
{
"id": "roster",
"type": "daslab/note",
"name": "Roster",
"fields": {
"content": "| Name | Instagram | TikTok | Facebook | X |\n|---|---|---|---|---|\n| Nike | nike | nike | https://www.facebook.com/nike | nike |\n| Bombas | bombas | bombas | | |\n| NY Fashion Tech Lab | nyftlab | | | |\n"
},
"layout": {
"sortOrder": 1,
"size": "large"
}
},
{
"id": "feed",
"type": "apify/feed",
"name": "Social data feed",
"fields": {
"platforms": "instagram, tiktok, facebook, x",
"note": "Enables the platform tools in this scene. Runs are metered on the scene's plan."
},
"layout": {
"sortOrder": 2,
"size": "icon"
}
},
{
"id": "dashboard",
"type": "daslab/webview",
"name": "Dashboard",
"fields": {
"html": "\n\n\n\n\nKOL Tracker\n\n\n\n \n KOL Tracker\n \n \n
\n \n \n\n\n\n\n",
"data": {
"type": "kol_tracker",
"updated_at": null,
"snapshot_at": null,
"brand_handles": [],
"kols": [],
"posts": []
}
},
"layout": {
"sortOrder": 3,
"size": "xlarge"
}
},
{
"id": "log",
"type": "daslab/note",
"name": "Run log",
"fields": {
"content": "_No runs yet. Use the **poll-now** task or wait for the next hourly run._\n"
},
"layout": {
"sortOrder": 4,
"size": "medium"
}
}
],
"schedules": [
{
"id": "hourly-posts",
"title": "New posts from the roster · hourly",
"cron": "15 * * * *",
"prompt": "Poll the roster for new posts.\n\n1. Read the **Roster** note. Each row is one creator: Name, Instagram username, TikTok username, Facebook page URL, X handle. An empty cell means the creator is not on that platform.\n2. Fetch what is new, in as few calls as possible, one call per platform with every handle in it. Skip a platform entirely when no row has a handle for it.\n - `apify_instagram_posts` with every Instagram username as `profiles`, `newer_than` \"2 hours\", `limit` 10.\n - `apify_tiktok_profiles` with every TikTok username, `videos_per_profile` 3, `newer_than` set to yesterday's date as YYYY-MM-DD.\n - `apify_facebook_posts` with every Facebook URL as `page_urls`, `newer_than` \"2 hours\", `limit` 10.\n - `apify_scrape_twitter` with every X handle as `handles`, `maxItems` 20; keep only tweets from the last two hours.\n3. Read the **Dashboard** cell with `daslab_read_cell` (`full: true`). Its data is the state: `{ type, updated_at, snapshot_at, brand_handles, kols[], posts[] }`. A kol is `{ name, handles: { instagram, tiktok, facebook, x }, followers: { instagram, tiktok, facebook, x }, history: [{ date, instagram, tiktok, facebook, x }], last_post_at }`. A post is `{ id, platform, kol, author, url, timestamp, text, likes, comments, shares, views, mentions_brand }`.\n4. Merge. For every fetched post build the post shape above with `kol` set to the roster Name it belongs to. `mentions_brand` is true when the text or mentions contain any of: ${inputs.brand_handles}. Add posts whose id is not present yet; for ids already present, update likes, comments, shares and views. Drop posts older than 60 days. Set each kol's `last_post_at`. Make sure every roster row exists in `kols` with its name and handles; never drop history.\n5. Write the merged state back with `daslab_write_data` on the Dashboard, keeping `type` \"kol_tracker\" and setting `updated_at` to now (ISO).\n6. Append one line to the **Run log** note, newest first: `poll · new · updated · $`.\n\nDo not summarise posts in prose. The dashboard renders them.",
"assetIds": [
"roster",
"dashboard",
"log"
],
"enabled": true,
"checks": [
{
"op": "contains",
"path": "log.content",
"substring": "poll",
"ci": true,
"why": "Every hourly run leaves a log line, so a silent run is visible."
},
{
"op": "lte",
"path": "$run.cost_usd",
"value": 2.5,
"expose": true,
"severity": "fail",
"why": "Hourly poll budget cap, model and data together."
}
]
},
{
"id": "daily-snapshot",
"title": "Follower snapshot · 01:30 UTC",
"cron": "30 1 * * *",
"prompt": "Snapshot follower counts for the roster.\n\n1. Read the **Roster** note (Name, Instagram, TikTok, Facebook, X per row).\n2. One call per platform with every handle in it: `apify_instagram_profiles` with every Instagram username; `apify_tiktok_profiles` with every TikTok username and `videos_per_profile` 1 (the profile comes with the video). Facebook and X have no follower tool here, so leave those counts as they were.\n3. Read the **Dashboard** cell with `daslab_read_cell` (`full: true`). For each kol set `followers.instagram` and `followers.tiktok` from the results, and append `{ date: today (YYYY-MM-DD), instagram, tiktok, facebook, x }` to its `history`, replacing today's entry if one exists and keeping at most 120 entries. Make sure every roster row exists in `kols`.\n4. Set `snapshot_at` to now and write the state back with `daslab_write_data` on the Dashboard, keeping `type` \"kol_tracker\".\n5. Append one line to the **Run log** note, newest first: `snapshot · creators · $`.",
"assetIds": [
"roster",
"dashboard",
"log"
],
"enabled": true,
"checks": [
{
"op": "contains",
"path": "log.content",
"substring": "snapshot",
"ci": true,
"why": "Every daily run leaves a log line."
},
{
"op": "lte",
"path": "$run.cost_usd",
"value": 5,
"expose": true,
"severity": "fail",
"why": "Daily snapshot budget cap."
}
]
}
],
"tasks": [
{
"id": "poll-now",
"name": "Poll for new posts now",
"prompt": "Run the hourly poll now, exactly as the scheduled run does: read the Roster, fetch posts newer than two hours per platform in one call per platform, merge into the Dashboard state with daslab_write_data, and append a `poll` line to the Run log.",
"initialState": {},
"tools": {
"expected": [
"daslab_read_cell",
"daslab_write_data",
"daslab_note_write"
]
},
"checks": [
{
"op": "contains",
"path": "log.content",
"substring": "poll",
"ci": true,
"why": "Proves the poll ran and logged."
},
{
"op": "lte",
"path": "$run.cost_usd",
"value": 2.5,
"expose": true,
"severity": "fail",
"why": "Task budget cap."
}
]
},
{
"id": "snapshot-now",
"name": "Snapshot follower counts now",
"prompt": "Run the daily follower snapshot now, exactly as the scheduled run does: read the Roster, fetch Instagram and TikTok profiles in one call per platform, update followers and history in the Dashboard state with daslab_write_data, and append a `snapshot` line to the Run log.",
"initialState": {},
"tools": {
"expected": [
"daslab_read_cell",
"daslab_write_data",
"daslab_note_write"
]
},
"checks": [
{
"op": "contains",
"path": "log.content",
"substring": "snapshot",
"ci": true,
"why": "Proves the snapshot ran and logged."
},
{
"op": "lte",
"path": "$run.cost_usd",
"value": 5,
"expose": true,
"severity": "fail",
"why": "Task budget cap."
}
]
},
{
"id": "add-creator",
"name": "Add a creator to the roster",
"prompt": "Add the creator named in the conversation to the **Roster** note as a new table row: Name, Instagram username, TikTok username, Facebook page URL, X handle, leaving unknown platforms empty. Then fetch that creator's profiles on the platforms given and add them to the Dashboard state (kols entry with handles and followers) with daslab_write_data. Confirm with the row you added.",
"initialState": {},
"tools": {
"expected": [
"daslab_note_write",
"daslab_write_data"
]
},
"checks": [
{
"op": "lte",
"path": "$run.cost_usd",
"value": 1,
"expose": true,
"severity": "fail",
"why": "Task budget cap."
}
]
}
],
"members": [
{
"email": "labhausxyz@gmail.com",
"role": "owner"
}
],
"meta": {
"author": "Daslab",
"license": "MIT",
"source": "blueprint — edit the Roster table, optionally bind --input brand_handles=yourbrand,#yourcampaign. No accounts to connect: the social feed runs on Daslab's data feed, metered on the scene's plan."
}
}