Agent skill · software engineering · pedronauck
tweetsmash-api
Integrate TweetSmash REST bookmark retrieval, filtering, pagination, and label management into scripts or tools. Excludes browser automation, other Twitter/X APIs, and marketing copy.
Why this skill is useful
Provides specific commands and procedures for interacting with the TweetSmash API that the AI wouldn't reliably generate on its own.
What it needs
Requires python3 installed locally. Requires tweetsmash account access. About 2k tokens when loaded. Last updated 2026-08-01. 564 stars on the source repository.
What this skill does
TweetSmash API Use this skill to work directly with the TweetSmash REST API using current endpoint evidence. Reuse documentation already verified in this task; refresh it when missing, stale, or contradicted by the API. Read references/api-reference.md before choosing an endpoint. Read references/bookmarks-filters.md only when bookmark filtering is required. Procedures Step 1: Validate Credentials and Scope 1. Confirm that a TweetSmash API key is available before making requests. Prefer TWEETSMASHAPIKEY in the shell environment. 2. Read references/api-reference.md to confirm the current endpoint, required headers, rate limits, and status codes. 3. If the task requires bookmark filtering or pagination, read references/bookmarks-filters.md. Step 2: Build the Request 1. Use Authorization: Bearer $TWEETSMASHAPIKEY on every request. 2. Use Content-Type: application/json for all examples in this skill. Keep the base URL as https://api.tweetsmash.com/v1. 3. If the task fetches bookmarks with filters, execute python3 <tweetsmash-api-dir>/scripts/build-bookmarks-url.py with the needed flags to generate a correctly encoded URL. 4. If the task adds labels, start from assets/add-labels-body.json and fill in tweetids plus either labelid or labelname. 5. If the task removes labels, start from assets/remove-labels-body.json and fill in tweetids plus labelname. Step 3: Execute the Correct Endpoint 1. Fetch bookmarks with GET /bookmarks. Use the URL from scripts/build-bookmarks-url.py when filters, search, or cursors are present. 2. List labels with GET /labels when the task needs current label IDs, label names, or usage counts. 3. Add labels with POST /labels/add when the task needs to organize one or more bookmarked tweets. 4. Remove labels with POST /labels/remove when the task needs to clean up or reclassify bookmarked tweets. 5. Use cURL for quick execution or translate the same request into the caller’s runtime only after the endpoint and payload are confirmed. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills pedronauck/tweetsmash-api