x-likes-digest

X Likes Digest

AI-powered daily digest and personalized recommendations for your X (Twitter) likes.

Automatically collects your liked tweets, categorizes and summarizes them with an LLM, and delivers a curated digest plus smart recommendations to Telegram, Discord, or Slack — every day.

---

How It Works

┌─────────────────────────────────────────────────────────────┐
│                        Architecture                         │
│                                                             │
│   X Official API                                            │
│        │                                                    │
│        ▼                                                    │
│   Collector (VPS/local, cron)                               │
│        │  npm run collect                                   │
│        ▼                                                    │
│   SQLite DB  ←──────────── npm run export                  │
│        │                                                    │
│        ▼                                                    │
│   OpenClaw Agent  (SKILL.md)                                │
│        │  categorize · summarize · score · recommend        │
│        ▼                                                    │
│   Telegram / Discord / Slack                                │
└─────────────────────────────────────────────────────────────┘

Two components:

---

Key Features

• 🗂 Auto-categorization — LLM groups posts into natural topic clusters (AI, Crypto, Dev Tools, etc.). Custom categories supported.
• 📝 Smart summarization — Full article extraction for X Articles and external links. Detailed summaries, not just titles.
• 🧠 LLM interest profiling — Builds a natural-language profile of your interests from like history. Refreshed weekly.
• 🎯 Scored recommendations — Candidates scored 0–10 against your profile. Filters out anti-patterns learned from feedback.
• 🌀 Serendipity picks — At least 2 recommendations from adjacent topics for unexpected discovery.
• 🔁 Feedback loop — Checks which recommended posts you actually liked. Accumulates negative signals to improve future scoring.
• 📡 Multi-platform delivery — Telegram, Discord, Slack via OpenClaw's channel system. Identical content, format-adapted per platform.

---

Two Modes

Digest Mode

Collects all new likes since the last run → categorizes → summarizes → delivers a structured digest.

📊 X Likes Digest — 2025/4/1
━━━━━━━━━━━━━━━━━━
📌 新規いいね: 24件

📂 カテゴリ内訳:
  🤖 AI / Dev: 9件
  💰 Crypto: 7件
  📝 Articles: 5件
  ...

Recommend Mode

Analyzes your interest profile → searches twitterapi.io → scores candidates → delivers top picks with reasoning.

💡 おすすめポスト（12件）
━━━━━━━━━━━━━━━━━━

🤖 AI / Dev
1. @author — Post title
   100–200 char summary of what's interesting
   📌 Why: matches "AI agent infra" interest pattern
   🎯 スコア: 8.5/10

---

Setup

1. VPS Collector

The collector runs on an always-on machine (VPS recommended) and fetches your likes daily.

# Clone and install
git clone https://github.com/nmn-labs/x-likes-digest.git
cd x-likes-digest
npm install

# Set up OAuth (one-time, requires browser)
npm run oauth:setup
# Follow the flow, then:
npm run oauth:exchange

# Test data collection
npm run collect

# Test export (what the OpenClaw agent reads)
npm run export

Copy .env.example to .env:

# X OAuth 2.0 (from X Developer Portal)
TWITTER_CLIENT_ID=your_client_id
TWITTER_CLIENT_SECRET=your_client_secret
TWITTER_USERNAME=your_x_username

# twitterapi.io (for recommend mode and article fetch)
TWITTERAPI_KEY=your_twitterapiio_key

See references/setup-guide.md for full database init and OAuth details.

2. OpenClaw Skill

Install the skill into your OpenClaw instance:

openclaw skill add nmn-labs/x-likes-digest

Or clone locally and add by path:

openclaw skill add /path/to/x-likes-digest

3. Configure Cron

Add two cron jobs — one for digest, one for recommendations:

# Digest — daily at 8:30 JST
openclaw cron add --name x-likes-digest \
  --schedule "30 8 * * *" --tz Asia/Tokyo \
  --message "Run x-likes-digest skill in digest mode. Config: ssh_host=your-server, vps_project_path=/home/user/x-likes-digest, telegram_channel_id=-100xxx, delivery_channels=[telegram]" \
  --channel telegram --timeout 900

# Recommend — daily at 8:45 JST
openclaw cron add --name x-likes-digest-recommend \
  --schedule "45 8 * * *" --tz Asia/Tokyo \
  --message "Run x-likes-digest skill in recommend mode. Config: ssh_host=your-server, vps_project_path=/home/user/x-likes-digest, telegram_channel_id=-100xxx, recommend_count=12, delivery_channels=[telegram]" \
  --channel telegram --timeout 600

For local mode (collector on same machine as OpenClaw), use local_db_path=/absolute/path/to/x-likes-digest instead of ssh_host.

---

Configuration Reference

Pass these in the cron --message or as context to the skill:

Multi-platform delivery is powered by OpenClaw's channel system. Each enabled channel receives identical content formatted for its platform (Markdown for Telegram/Discord, mrkdwn for Slack).

---

Available Scripts

---

⚠️ API Cost Safety

twitterapi.io is a paid API (~$0.015/request). The skill enforces guards:

• Max 7 search queries per recommend run, 1 page each
• Deduplication check before paginating
• Stops immediately on repeated cursors (loop detection)

Always test with a single page before running full collection.

---

Contributing

Contributions welcome. See CONTRIBUTING.md for guidelines.

Quick start:

1. Fork and create a feature branch: git checkout -b feature/your-feature
2. Test by installing your fork: openclaw skill add <your-fork>/x-likes-digest
3. Submit a PR with a CHANGELOG entry

---

License

MIT — © nmn-labs

---

---

X Likes Digest（日本語）

AIによるX（Twitter）いいね日次ダイジェスト & パーソナライズされたおすすめポスト配信ツール。

いいねしたツイートを自動収集し、LLMでカテゴリ分類・要約したうえで、毎日Telegram/Discord/Slackへ配信。さらにあなたの興味プロ