agentsclimarketplace
Sign in

Twitter connector skill

Skill ShellyDeng08/twitter-connector-skill

Search Twitter/X using local Playwright automation with saved cookies (no API key). Use this skill whenever the user asks to find tweets, trending posts, public reactions, or latest discussions on X/Twitter for any topic, including phrasing like “search X”, “find tweets about…”, “what are people saying on Twitter”, “top tweets”, or “recent tweets”. Also use it when the user wants tweet results returned as structured JSON for downstream analysis, or wants tweet detail by a tweet URL.From its SKILL.md

Install
npx -y skills add ShellyDeng08/twitter-connector-skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.7 KB, 559 tokens by cl100k_base, as published. Nobody here has run it

Twitter Connector

Use this skill to run lightweight Twitter/X search and tweet-detail retrieval from this project.

What this skill does

  • Performs Twitter/X search via Playwright browser automation
  • Supports tweet detail retrieval by tweet URL
  • Reuses saved login cookies from scripts/twitter_cookies.json
  • Returns tweet results in JSON (good for follow-up analysis)

Workflow

  1. Dependency check is built-in (auto detect + auto install):

    • scripts/login.py and scripts/search.py will automatically detect missing playwright
    • If missing, they will auto-run install for playwright and Chromium browser
    • So you can run commands directly without manual dependency setup

  2. If cookie file is missing or expired, run login first:

python3 scripts/login.py
  1. Run keyword search or tweet detail:
python3 scripts/search.py "QUERY" --limit 10 --sort top --json-only
python3 scripts/search.py --url "https://x.com/jack/status/20" --json-only

Search/detail parameters

  • QUERY (optional): search phrase, or a tweet URL (https://twitter.com/{user}/status/{id} / https://x.com/{user}/status/{id})
  • --url (optional): explicit tweet URL for detail mode
  • --limit (optional): number of tweets to return in search mode (default 10, clamped to 1-50)
  • --sort (optional): top (engagement-focused) or live (latest), search mode only
  • --json-only (optional): prints only the JSON array (best for machine parsing)

Example commands

python3 scripts/search.py "Claude Code" --limit 8 --sort top --json-only
python3 scripts/search.py "AI agent framework" --limit 10 --sort live --json-only
python3 scripts/search.py --url "https://x.com/jack/status/20" --json-only
python3 scripts/search.py "https://twitter.com/jack/status/20" --json-only

Output shape

Each tweet entry includes:

  • text
  • user
  • time
  • likes
  • retweets
  • replies
  • link

Output is always a JSON array:

  • Search mode: up to --limit items
  • Detail mode: one item when successful, otherwise []

Usage boundaries

  • Keep usage light (personal/manual exploration)
  • If login state expires, re-run scripts/login.py
  • Don’t use this workflow for mass scraping

What ships with it: 4 files

15.5 KB alongside SKILL.md, 2 of them executable

scripts/

Keep looking

Skills are one crate of 326,758. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.