OpenParable
Skip to content
← Back to skills

Twitter Summary

Apps & Automation
twitter-summary

Twitter 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
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 timestamp
  • type — tweet, reply, or retweet
  • text — Tweet content
  • url — 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.