# Twitter Monitor

Fetch recent posts from one or more X/Twitter accounts through twitterapi.io, output...

- Repository: https://github.com/kangarooking/kangarooking-skills (694 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-09-07
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add kangarooking/kangarooking-skills --skill twitter-monitor -g -a claude-code -y`
Codex: `npx skills add kangarooking/kangarooking-skills --skill twitter-monitor -g -a codex -y`
Cursor: `npx skills add kangarooking/kangarooking-skills --skill twitter-monitor -g -a cursor -y`
Gemini CLI: `npx skills add kangarooking/kangarooking-skills --skill twitter-monitor -g -a gemini-cli -y`

## Description

Fetch recent posts from one or more X/Twitter accounts through twitterapi.io, output structured JSON/CSV records, optionally sync records to Feishu/Lark Bitable through feishu-cli, and optionally guide recurring execution through OpenClaw, Codex automations, cron, or launchd. Use when the user wants to monitor X bloggers, collect recent tweets, export tweet metrics, append tweets to Feishu Bitable, or set up a scheduled Twitter/X account tracking workflow.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Twitter Monitor

## Workflow

Use this skill as an execution workflow, not as a long-running daemon. First complete a one-shot fetch, then offer optional Feishu sync and scheduling only when useful.

1. Ask for X/Twitter account ids when missing. Accept handles such as `sama`, `@sama`, profile URLs, or multiple comma-separated ids.
2. Ask the user to provide or configure a `twitterapi.io` API key when `TWITTER_API_KEY` is unavailable. Do not write API keys into files committed to a repository.
3. Confirm pagination depth. Default to `--pages 1`; use a larger number only when the user asks for more history or accepts higher API usage.
4. Run `scripts/twitter_monitor.py` and generate JSON or CSV output.
5. If the user wants Feishu/Lark Bitable output, follow `references/feishu-output.md`.
6. After the one-shot command works, ask whether they want recurring execution. If yes, follow `references/scheduling.md`, including OpenClaw when appropriate.

## Quick Start

From this skill directory:

```bash
export TWITTER_API_KEY="..."
python scripts/twitter_monitor.py --accounts sama --pages 1 --format json
```

For multiple accounts:

```bash
python scripts/twitter_monitor.py --accounts sama,elonmusk,OpenAI --pages 1 --format csv
```

For a JSON account list:

```bash
python scripts/twitter_monitor.py --accounts-file assets/accounts.example.json --pages 1
```

Read `references/twitterapi-setup.md` when the user needs API key setup, account input examples, or command variants.

## Output Schema

The script writes one record per tweet with these fields:

- `推文内容`
- `日期`
- `推文链接`
- `推文ID`
- `作者`
- `作者ID`
- `阅读量`
- `点赞数`
- `转发数`
- `评论数`
- `收藏数`
- `是否回复`
- `抓取时间`

Deduplicate by `推文ID` before appending to any durable destination.

## Feishu

Do not require Feishu configuration for normal fetches. Only enter the Feishu workflow when the user asks to write, append, or sync records to Feishu/Lark Bitable.

The rest: https://github.com/kangarooking/kangarooking-skills/blob/HEAD/twitter-monitor/SKILL.md