Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add pedronauck/skills --skill tweetsmash-api -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/tweetsmash-api/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/tweetsmash-api/

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.

Similar skills

All skills for Agent setup: memory, context, orchestration →
raindrop-api intellectronica The raindrop-api skill lets an AI agent work with Raindrop.io bookmarks through its REST API. Use it to search, create, edit, and organise saved links. CX Codex +1 511installs api-filtering-sorting secondsky api-filtering-sorting is a Claude Code, Codex, Cursor, and other agents skill that builds API filtering and sorting from query parameters, checks fields against an allowlist, and prevents injections. CX Codex +1 438installs x-api-integration VoltAgent Community x-api-integration is a Claude Code subagent that structures integrations with the X/Twitter API and alternative providers. Configures tweet ingestion pipelines, profile enrichment, and webhooks. CX Codex ★ 26,718repo stars recoup-platform-api-access recoupable recoup-platform-api-access enables direct calls to the Recoup REST API and external connectors. Useful for querying artist rosters, scraping social metrics, and modifying cloud documents. CX Codex +1 5,500installs fieldtheory-cli-bookmarks reason-machines fieldtheory-cli-bookmarks — a skill for Claude Code, Codex, Cursor, Copilot, Gemini CLI and OpenCode that hands the agent Field Theory CLI commands. X/Twitter bookmarks get synced to a local database, indexed, and searched by content. CX Codex +1 635installs notion-api intellectronica A skill for interacting with the Notion API through REST requests. Gives agents full access to pages, databases, blocks, and comments — read, create, update, and delete content. CX Codex +1 106,200installs

From the same set52

The whole set →
promo-video Generates polished product promo videos with Remotion, ElevenLabs voiceovers, and background music directly from repository context. CX Codex +1 257installs tech-logos The tech-logos skill guides the reuse and addition of official company, provider, and social-platform logos in landing, auth, and integration interfaces. CX Codex +1 256installs fundraising This skill walks you through an end-to-end fundraising process for early-stage founders: from deciding whether to raise venture capital to building a pitch narrative, targeting investors, running outreach, and preparing for due diligence. CX Codex +1 252installs xstate This skill covers XState v5 machines, actors, stores, and TanStack Query integration. Use it when application logic needs explicit state flows. CX Codex +1 247installs herdr-orchestration herdr-orchestration controls interactive Claude and Codex worker TUIs in dedicated herdr tabs using socket CLI commands. CX Codex +1 210installs writing-tech-post writing-tech-post — a skill for writing and editing engineering posts with supported claims. Use it to draft new articles, rework existing drafts, or review content before publication. CX Codex +1 182installs ship-pr ship-pr delivers finished work with documentation audits, release note grouping, compliant commits, and a pull request. CX Codex +1 181installs kb-yt-channel kb-yt-channel — a skill that builds Karpathy KB topics from YouTube channels: the agent fetches transcripts, organizes them into topic folders, validates structure, and creates search indexes. CX Codex +1 175installs

Project sponsors

Companies that keep this analytics open