voidborne-d
b04212680d
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.
2.7 KiB
2.7 KiB
Hermes Setup Guide for last30days
This guide covers installing last30days on Hermes AI Agent.
Prerequisites
- Hermes installed - See https://github.com/mercurial-tf/hermes
- Python 3.12+ -
brew install python@3.12or similar - yt-dlp (optional, for YouTube) -
brew install yt-dlp
Installation
hermes skills install mvanhorn/last30days-skill --force
This pulls the latest release from GitHub and deploys to ~/.hermes/skills/research/last30days/. --force reinstalls over any existing copy.
Developer / live-edit alternative
If you're hacking on the skill locally and want edits to propagate to Hermes without re-installing, symlink your working tree:
git clone https://github.com/mvanhorn/last30days-skill.git
mkdir -p ~/.hermes/skills/research
ln -s "$(pwd)/last30days-skill/skills/last30days" ~/.hermes/skills/research/last30days
Usage
In Hermes, invoke with:
last30days "your research topic"
Or with options:
last30days "best mechanical keyboards 2025" --search=reddit,youtube
last30days "AI news" --days=7 --deep
First Run Setup
On first run, the skill will guide you through setup:
-
Auto setup (~30 seconds)
- Scans browser cookies for X/Twitter
- Checks/installs yt-dlp for YouTube
- Configures free sources (Reddit, HN, Polymarket)
-
Optional: ScrapeCreators
- Adds TikTok, Instagram, Reddit backup
- 100 free credits (no expiration)
- Sign up at scrapecreators.com
-
Optional: API Keys
- XAI_API_KEY for X/Twitter (alternative to browser cookies)
- BRAVE_API_KEY for web search
Available Sources
Free (No API Key)
- Reddit - Public discussions and comments
- Hacker News - Tech discussions via Algolia
- Polymarket - Prediction markets
- YouTube - Search and transcripts (requires yt-dlp)
Requires API Key
- X/Twitter - xAI API key or browser cookies
- TikTok - ScrapeCreators API
- Instagram - ScrapeCreators API
- Web Search - Brave Search API
Troubleshooting
Python not found
# Find Python 3.12+
which python3.12 python3.13 python3.14
# If not installed
brew install python@3.12
yt-dlp not found
brew install yt-dlp
# or
pip install yt-dlp
Check what's configured
cd ~/.hermes/skills/research/last30days
python3.12 scripts/last30days.py --diagnose
Updating
hermes skills install mvanhorn/last30days-skill --force
If you symlinked your working tree (developer alternative above), just git pull in the repo — edits propagate live, no re-install step.
Support
- Original repo: https://github.com/mvanhorn/last30days-skill
- Hermes: https://github.com/mercurial-tf/hermes
- Issues: Please report in the original repo