From b04212680d25472d04ea014d1db6d2761d320a07 Mon Sep 17 00:00:00 2001 From: voidborne-d <221476878+voidborne-d@users.noreply.github.com> Date: Sun, 10 May 2026 04:34:56 +0800 Subject: [PATCH] docs: correct ScrapeCreators free tier to 100 credits (closes #367) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The skill advertises ScrapeCreators as offering "10,000 free API calls" in six places. The actual free tier on the ScrapeCreators pricing page is "100 credits free · No credit card required · Credits never expire" — a 100x overstatement that surprises users on signup. Reporter (#367) burned through their full free allocation on a single /last30days run after taking the 10,000-call claim at face value. They verified the actual tier directly against scrapecreators.com plus an independent review at fahimai.com. Sweep: - hooks/scripts/check-config.sh:110 (SessionStart hook tip line) - README.md:228 (Sources × Cost table row) - HERMES_SETUP.md:62 (Optional: ScrapeCreators bullet) - skills/last30days/scripts/lib/ui.py:199 (PROMO_SINGLE_KEY["reddit"]) - skills/last30days/SKILL.md:1648 ("PAYG after 10,000 free API calls") - skills/last30days/SKILL.md:1661 ("10,000 free API calls, then PAYG") Wording defaults to the provider's own framing — "100 free credits" — and keeps PAYG language where it was already explicit, since the paid step is the part users were actually getting blindsided by. CI gates: tests/test_plugin_contract.py (4) + tests/test_version_consistency.py (4) all pass. shellcheck clean. No tests pin the "10,000" string. --- HERMES_SETUP.md | 2 +- README.md | 2 +- hooks/scripts/check-config.sh | 2 +- skills/last30days/SKILL.md | 4 ++-- skills/last30days/scripts/lib/ui.py | 2 +- 5 files changed, 6 insertions(+), 6 deletions(-) diff --git a/HERMES_SETUP.md b/HERMES_SETUP.md index f72d667..3558002 100644 --- a/HERMES_SETUP.md +++ b/HERMES_SETUP.md @@ -51,7 +51,7 @@ On first run, the skill will guide you through setup: 2. **Optional: ScrapeCreators** - Adds TikTok, Instagram, Reddit backup - - 10,000 free API calls + - 100 free credits (no expiration) - Sign up at scrapecreators.com 3. **Optional: API Keys** diff --git a/README.md b/README.md index dfdfbf2..6ec4ab1 100644 --- a/README.md +++ b/README.md @@ -256,7 +256,7 @@ These platforms don't have relationships with each other. X doesn't know what Re | X / Twitter | Log into x.com in any browser | Free | | YouTube | `brew install yt-dlp` | Free | | Bluesky | App password from bsky.app | Free | -| TikTok + Instagram + Threads + Pinterest + YouTube comments | ScrapeCreators key | 10,000 free calls | +| TikTok + Instagram + Threads + Pinterest + YouTube comments | ScrapeCreators key | 100 free credits, then PAYG | | Perplexity Sonar | OpenRouter key | Pay as you go | | Web search | Brave Search key | 2,000 free queries/month | diff --git a/hooks/scripts/check-config.sh b/hooks/scripts/check-config.sh index 85403cc..bc57dd5 100755 --- a/hooks/scripts/check-config.sh +++ b/hooks/scripts/check-config.sh @@ -120,6 +120,6 @@ else # Setup done but missing ScrapeCreators — recommend it echo "/last30days: Ready — ${SOURCE_COUNT} sources active." echo " Tip: Add ScrapeCreators for Reddit comments + TikTok + Instagram." - echo " 10,000 free API calls, no credit card — scrapecreators.com" + echo " 100 free credits, no credit card — scrapecreators.com" echo " last30days has no affiliation with any API provider." fi diff --git a/skills/last30days/SKILL.md b/skills/last30days/SKILL.md index 16f89b6..ab865e9 100644 --- a/skills/last30days/SKILL.md +++ b/skills/last30days/SKILL.md @@ -1690,7 +1690,7 @@ Want another prompt? Just tell me what you're creating next. - Sends search queries to Algolia HN Search API (`hn.algolia.com`) for Hacker News story and comment discovery (free, no auth) - Sends search queries to Polymarket Gamma API (`gamma-api.polymarket.com`) for prediction market discovery (free, no auth) - Runs `yt-dlp` locally for YouTube search and transcript extraction (no API key, public data) -- Sends search queries to ScrapeCreators API (`api.scrapecreators.com`) for TikTok and Instagram search, transcript/caption extraction (PAYG after 10,000 free API calls) +- Sends search queries to ScrapeCreators API (`api.scrapecreators.com`) for TikTok and Instagram search, transcript/caption extraction (PAYG after 100 free credits) - Optionally sends search queries to Brave Search API, Parallel AI API, or OpenRouter API for web search - Fetches public Reddit thread data from `reddit.com` for engagement metrics - Stores research findings in local SQLite database (watchlist mode only) @@ -1703,7 +1703,7 @@ Want another prompt? Just tell me what you're creating next. - Does not log, cache, or write API keys to output files - Does not send data to any endpoint not listed above - Hacker News and Polymarket sources are always available (no API key, no binary dependency) -- TikTok and Instagram sources require SCRAPECREATORS_API_KEY (10,000 free API calls, then PAYG). Reddit uses ScrapeCreators only as a backup when public Reddit is unavailable. +- TikTok and Instagram sources require SCRAPECREATORS_API_KEY (100 free credits one-time, then PAYG). Reddit uses ScrapeCreators only as a backup when public Reddit is unavailable. - Can be invoked autonomously by agents via the Skill tool (runs inline, not forked); pass `--agent` for non-interactive report output **Bundled scripts:** `scripts/last30days.py` (main research engine), `scripts/lib/` (search, enrichment, rendering modules), `scripts/lib/vendor/bird-search/` (vendored X search client, MIT licensed) diff --git a/skills/last30days/scripts/lib/ui.py b/skills/last30days/scripts/lib/ui.py index 1dfd1ec..475261d 100644 --- a/skills/last30days/scripts/lib/ui.py +++ b/skills/last30days/scripts/lib/ui.py @@ -198,7 +198,7 @@ Just start with "last30" and talk to me like normal. # Shorter promo for single missing key PROMO_SINGLE_KEY = { - "reddit": "\n💡 Unlock TikTok and Instagram with SCRAPECREATORS_API_KEY - 10,000 free calls, no CC - scrapecreators.com\n", + "reddit": "\n💡 Unlock TikTok and Instagram with SCRAPECREATORS_API_KEY - 100 free credits, no CC - scrapecreators.com\n", "x": "\n💡 Unlock X: log into x.com in Firefox or Safari, then re-run. Or add AUTH_TOKEN/CT0 or XAI_API_KEY.\n", "web": "\n💡 You can unlock native grounded web search with BRAVE_API_KEY or SERPER_API_KEY.\n", }