tweetsmash-api — Claude Code skill: bookmark retrieval and filtering
tweetsmash-api — a skill for integrating TweetSmash REST API into scripts and tools. Retrieve bookmarks, apply filters, paginate, and manage labels without browser automation.
no license 214 installs ★ 655 updated 2026-10-20
npx skills add pedronauck/skills --skill tweetsmash-api -a claude-codeWhat tweetsmash-api does
This skill exposes TweetSmash REST API endpoints for programmatic bookmark management. Fetch bookmarks with optional filtering, step through pages using cursors, and add or remove labels from groups of tweets. Requests use standard HTTP with Bearer token authentication; complex filters are built by running the included build-bookmarks-url.py script.
Setup requires a TweetSmash API key in the TWEETSMASH_API_KEY environment variable. The skill includes reference docs for current endpoints, filter formats, and JSON templates for label mutations. Response handling checks status codes — 402 means your plan lacks API access, 429 triggers exponential backoff using Retry-After headers.
Best for server-side scripts that organize bookmarks automatically. Browser automation and other Twitter/X APIs are out of scope.
What it helps with
- fetch bookmarks filtered by date, author, or keyword
- apply or remove a label across multiple bookmarked tweets
- paginate through bookmarks using cursor-based navigation
- handle rate limits and authentication errors gracefully
- build URL-encoded filter parameters without manual concatenation
Example prompts for the agent
- Get my bookmarks from the past month and group them by author
- Add the label 'ai-research' to all bookmarks containing 'transformer' or 'llm'
- Iterate through bookmarks 50 at a time, save them to JSON, and pause before the next batch if rate-limited
How to install tweetsmash-api
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill tweetsmash-api -a claude-code2Manually: put the files in place
~/.claude/skills/tweetsmash-api/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/tweetsmash-api/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill tweetsmash-api -a codex2Manually: put the files in place
.agents/skills/tweetsmash-api/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill tweetsmash-api -a cursor2Manually: put the files in place
.cursor/skills/tweetsmash-api/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install pedronauck/skills skills/mine/tweetsmash-api2Manually: put the files in place
.github/skills/tweetsmash-api/SKILL.md1Skills CLI (Vercel)
npx skills add pedronauck/skills --skill tweetsmash-api -a gemini-cli2Platform CLI
gemini skills install https://github.com/pedronauck/skills --path skills/mine/tweetsmash-apiManually: put the files in place
.devin/skills/tweetsmash-api/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add pedronauck/skills --skill tweetsmash-api -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about tweetsmash-api
How do I install tweetsmash-api in Claude Code?
Run npx skills add pedronauck/skills --skill tweetsmash-api -a claude-code, then load the skill via ~/.claude/skills/tweetsmash-api/SKILL.md.
What does tweetsmash-api do?
It provides access to the TweetSmash REST API: list bookmarks with filtering options, navigate by page, add or remove labels. Requests use HTTP with Bearer token auth.
What API key do I need?
You need a TweetSmash API key in the TWEETSMASH_API_KEY environment variable. The skill validates it before making requests and returns 401 if missing or invalid.