Bitterbot-AI/social-data
skills/social-data/SKILL.md
Search and fetch social media data from Twitter/X, Reddit, and Hacker News.
$ install --global
skillsauthnpx skillsauth add Bitterbot-AI/bitterbot-desktop social-dataInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 21, 2026, 11:32 PM113.9s1 file scanned
SKILL.md
- name:
- social-data
- description:
- Search and fetch social media data from Twitter/X, Reddit, and Hacker News.
- metadata:
- { "bitterbot": { "emoji": "\uD83D\uDCF1" } }
Social Data
Access social media content from multiple platforms. Some require API keys, some are free.
Hacker News (free, no key)
Top Stories
curl -s "https://hacker-news.firebaseio.com/v0/topstories.json" | head -c 200
Returns array of item IDs. Fetch individual items:
curl -s "https://hacker-news.firebaseio.com/v0/item/12345678.json"
Search (via Algolia, free)
curl -s "https://hn.algolia.com/api/v1/search?query=rust+programming&tags=story&hitsPerPage=10"
tags:story,comment,ask_hn,show_hn,pollnumericFilters:created_at_i>1700000000(Unix timestamp)- Response:
hits[]array withtitle,url,author,points,num_comments
Front Page
curl -s "https://hn.algolia.com/api/v1/search?tags=front_page&hitsPerPage=30"
Reddit (free, no key for public data)
Subreddit Posts
curl -s "https://www.reddit.com/r/programming/hot.json?limit=10" \
-H "User-Agent: bitterbot/1.0"
Sort options: hot, new, top, rising
For top: add ?t=hour|day|week|month|year|all
Search Reddit
curl -s "https://www.reddit.com/search.json?q=rust+async&sort=relevance&limit=10" \
-H "User-Agent: bitterbot/1.0"
Post Comments
curl -s "https://www.reddit.com/r/programming/comments/POST_ID.json" \
-H "User-Agent: bitterbot/1.0"
Response is array of two listings: [0] = post, [1] = comments tree.
User Profile (public)
curl -s "https://www.reddit.com/user/USERNAME/submitted.json?limit=10" \
-H "User-Agent: bitterbot/1.0"
Twitter/X (requires API key)
Requires TWITTER_BEARER_TOKEN env var (from X Developer Portal).
Search Recent Tweets
curl -s "https://api.twitter.com/2/tweets/search/recent?query=from:elonmusk&max_results=10&tweet.fields=created_at,public_metrics" \
-H "Authorization: Bearer $TWITTER_BEARER_TOKEN"
Query operators:
from:username— tweets by userto:username— replies to user#hashtag— hashtag search"exact phrase"— exact match-is:retweet— exclude retweetslang:en— language filterhas:media— tweets with media
User Lookup
curl -s "https://api.twitter.com/2/users/by/username/elonmusk?user.fields=public_metrics,description,created_at" \
-H "Authorization: Bearer $TWITTER_BEARER_TOKEN"
User Timeline
curl -s "https://api.twitter.com/2/users/USER_ID/tweets?max_results=10&tweet.fields=created_at,public_metrics" \
-H "Authorization: Bearer $TWITTER_BEARER_TOKEN"
Tips
- Always include
User-Agentheader for Reddit (they block default agents). - Reddit JSON endpoints append
.jsonto any Reddit URL. - HN Algolia API is the most reliable for search; Firebase API for real-time data.
- Twitter free tier allows 500K tweets/month read access.
- For rate-limited APIs, cache results and avoid repeated identical queries.
- Use
web_fetchfor HTML pages,exec+curlfor JSON APIs.
Related Skills
Bitterbot-AI/route-by-query-shape
development
VerifiedTrustedCommunity
When the agent calls memory_search with a relationship-shaped query ("who did I talk to about X"), redirect to the knowledge_graph backend where it will actually find the answer.
1,881SKILL.mdUpdated May 23, 2026
Bitterbot-AI/recall-before-claim
testing
VerifiedTrustedCommunity
Forces a memory_search before the agent sends a message containing a factual assertion that has not yet been grounded this turn. Closes the citation-rate gap from ~40% to ~90%+.
1,881SKILL.mdUpdated May 23, 2026
Bitterbot-AI/protocol-quiet-in-groups
business
VerifiedTrustedCommunity
Enforces PROTOCOLS.md "stay quiet in group chats" deterministically. Blocks outbound messages in Discord/Telegram/Slack/etc group channels when the bot was not @mentioned and recently spoke.
1,881SKILL.mdUpdated May 23, 2026
Bitterbot-AI/calibrate-claim-confidence
development
VerifiedTrustedCommunity
When the agent's epistemic state (GCCRF) indicates low empowerment and falling certainty, hedges out confident absolutes ("definitely", "always", "100%") in outgoing messages.
1,881SKILL.mdUpdated May 23, 2026