Twitter Summary
Apps & Automationtwitter-summaryTwitter Summary is an Agent Skill for apps & automation published in the rcarmo/piclaw repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Fetch a user's recent tweets (tweets, replies, retweets) using Playwright + Nitter fallbacks and produce compact JSON/Markdown summaries.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/rcarmo/piclaw/blob/HEAD/skel/.pi/skills/twitter-summary/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/twitter-summary, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Twitter Summary
Scrape a public Twitter/X profile via Nitter front-ends and return a compact JSON listing of tweets, replies, and retweets within a time window.
Two scrapers are included:
playwright-twitter-summary.ts— uses Playwright for full browser rendering (more reliable)quick-twitter-summary.ts— uses linkedom for lightweight HTML parsing (no browser needed)
Prerequisites
The wrapper auto-installs Playwright if missing (logs to /tmp/twitter-playwright-install.log).
For the quick scraper:
cd /workspace && bun add linkedom
Usage
Using the wrapper script:
/workspace/.pi/skills/twitter-summary/run <handle> [hours] [output.json]
<handle> is required. No default user handle is configured in the scripts.
Examples:
# Fetch last 16 hours for an explicit handle
/workspace/.pi/skills/twitter-summary/run <handle> 16 /tmp/twitter_fetch.json
# Direct Playwright invocation
bun /workspace/.pi/skills/twitter-summary/playwright-twitter-summary.ts --handle=<handle> --hours=24
# Quick (no browser) invocation
bun /workspace/.pi/skills/twitter-summary/quick-twitter-summary.ts --handle=<handle> --hours=12
Output
JSON with handle, instance, count, and items array. Each item has:
date— ISO 8601 timestamptype—tweet,reply, orretweettext— Tweet contenturl— Link to the tweet on the Nitter instance
Notes
- The scrapers try several public Nitter instances and use the first that responds.
- Coverage varies by instance; combining outputs from multiple instances often yields the best results.
- Network restrictions or anti-bot protections may affect results.
- Logs are written to stderr; JSON output goes to stdout.
- A log file is written to /tmp/twitter-summary.log when using the wrapper.