twitter-cli

分类: 开发与编程 | 上传者: jackwener | 下载: 0 | 版本: v1.0（最新）

CLI skill for Twitter/X to read timelines, bookmarks, user posts, and profiles from the terminal without API keys

更新日志: Source: GitHub https://github.com/jackwener/twitter-cli

目录结构

当前层级: 根目录

📁 .github/
- 📁 workflows/
  - 📄 ci.yml 531 B
  - 📄 publish-clawhub.yml 1.6 KB
  - 📄 publish.yml 578 B
📁 tests/
- 📄 conftest.py 1.1 KB
- 📄 test_cli.py 1.6 KB
- 📄 test_config.py 1.3 KB
- 📄 test_config_normalization.py 1.0 KB
- 📄 test_filter.py 879 B
- 📄 test_serialization.py 749 B
📁 twitter_cli/
- 📄 __init__.py 63 B
- 📄 auth.py 6.2 KB
- 📄 cli.py 10.0 KB
- 📄 client.py 26.4 KB
- 📄 config.py 4.3 KB
- 📄 constants.py 334 B
- 📄 filter.py 2.7 KB
- 📄 formatter.py 7.3 KB
- 📄 models.py 1.3 KB
- 📄 serialization.py 4.9 KB
📄 .gitignore 80 B
📄 config.yaml 204 B
📄 pyproject.toml 1.5 KB
📄 README.md 6.8 KB
📄 SKILL.md 1.6 KB
📄 uv.lock 111.1 KB

SKILL.md

---
name: twitter-cli
description: CLI skill for Twitter/X to read timelines, bookmarks, user posts, and profiles from the terminal without API keys
author: jackwener
version: "1.0.0"
tags:
  - twitter
  - x
  - social-media
  - terminal
  - cli
---

# twitter-cli Skill

Use this skill when the user wants to read Twitter/X content from terminal without API keys.

## Requirements

- `twitter-cli` installed and available in PATH.
- User is logged in to `x.com` in Chrome/Edge/Firefox/Brave, or sets:
  - `TWITTER_AUTH_TOKEN`
  - `TWITTER_CT0`

## Core Commands

```bash
# Home timeline (For You)
twitter feed

# Following timeline
twitter feed -t following

# Bookmarks
twitter favorite

# Likes (own liked tweets)
twitter likes

# User profile and posts
twitter user <screen_name>
twitter user-posts <screen_name> --max 20
```

## JSON / Scripting

```bash
# Export feed as JSON
twitter feed --json > tweets.json

# Read from local JSON file
twitter feed --input tweets.json
```

## Ranking Filter

Filtering is opt-in (disabled by default). Enable with `--filter`.

```bash
twitter feed --filter
twitter favorite --filter
twitter likes --filter
```

The scoring formula:

```text
score = likes_w * likes
      + retweets_w * retweets
      + replies_w * replies
      + bookmarks_w * bookmarks
      + views_log_w * log10(max(views, 1))
```

Configure weights and mode in `config.yaml`.

## Safety Notes

- Do not ask users to share raw cookie values in chat logs.
- Prefer local browser cookie extraction over manual secret copy/paste.
- If auth fails with 401/403, ask the user to re-login to `x.com`.

登录后下载/点赞/收藏 ❤ 24 | ★ 0

twitter-cli

目录结构

SKILL.md

举报内容

提示