🔖 Bookmark Intelligence

Turn your X (Twitter) bookmarks into actionable insights, automatically.

Bookmark Intelligence watches your X bookmarks, fetches the full content from linked articles, analyzes everything with AI, and surfaces ideas relevant to YOUR projects. Stop letting great content sit in your bookmarks — let AI extract the value for you.

---

💎 Pricing & Tiers

Bookmark Intelligence offers three tiers to fit your needs:

🆓 Free Tier

Perfect for trying it out

• Price: $0/month
• 10 bookmarks per month
• Manual run only (no automation)
• Basic keyword analysis (no AI)
• No notifications
• Rate limited: 1 run per hour

⭐ Pro Tier - $9/month

Best for individuals

• Unlimited bookmarks
• Automated monitoring (background daemon)
• Full AI-powered analysis (GPT-4o-mini)
• Telegram notifications
• Priority support

🚀 Enterprise Tier - $29/month

For teams and power users

• Everything in Pro, plus:
• Team sharing & collaboration
• Custom AI models (bring your own API keys)
• API access for integrations
• Slack & Discord notifications
• Webhook support
• Dedicated support

Annual plans available - Save 2 months (16% off)!

How to Upgrade

1. Check your current tier:

```bash npm run license:check ```

1. View upgrade options:

```bash npm run license:upgrade ```

1. Choose payment method:

- Credit Card (Stripe) - Crypto (USDC on Polygon)

1. Activate your license:

```bash node scripts/license.js activate YOUR-LICENSE-KEY ```

---

📋 Quick Start

Total setup time: ~5 minutes

1. Run the setup wizard:

```bash cd skills/bookmark-intelligence npm run setup ```

1. The wizard will:

- ✅ Check if you have the required tools installed - 🍪 Guide you through getting your X cookies (step-by-step) - 🎯 Ask about your active projects & interests - ⚙️ Configure notification preferences - 🧪 Test your credentials

1. Run it once to process your current bookmarks:

```bash npm start ```

1. Set it up as a background daemon (optional but recommended):

```bash npm run daemon ```

That's it! You're done. 🎉

---

🎯 What It Does

The Problem

You bookmark tons of great content on X, but:

• You never go back to read it
• The tweets link to articles you don't have time to read
• You forget why you bookmarked something
• You miss connections to your current projects

The Solution

Bookmark Intelligence:

1. Monitors your X bookmarks automatically
2. Fetches the full content from any linked articles (not just the tweets)
3. Analyzes everything with AI to extract key concepts and actionable items
4. Relates insights to YOUR specific projects and interests
5. Notifies you (via Telegram) when it finds something valuable
6. Stores everything in a searchable knowledge base

Example Output

You bookmark a tweet about "vector embeddings for AI memory" → The skill:

• Fetches the linked article
• Extracts: key concepts, actionable implementation steps, code patterns
• Relates it to your "trading bot" and "agent memory" projects
• Suggests: "Store market analysis as embeddings to find historical patterns"
• Saves the full analysis to life/resources/bookmarks/bookmark-123.json
• Sends you a Telegram notification with the summary

See examples/sample-analysis.json for a full example.

---

🍪 Getting Your X Cookies (Step-by-Step)

You need two cookies from X.com. Don't worry, this is safe and takes 2 minutes.

Chrome / Edge / Brave

1. Open https://x.com in your browser
2. Make sure you're logged in
3. Press F12 (opens Developer Tools)
4. Click the Application tab at the top
5. In the left sidebar:

- Expand Cookies - Click https://x.com

1. You'll see a list of cookies. Find these two:

- auth_token → Copy the Value column - ct0 → Copy the Value column

┌─────────────────────────────────────────┐
│ Application  Console  Sources  ...     │ ← Click "Application"
├─────────────────────────────────────────┤
│ ▼ Storage                               │
│   ▼ Cookies                             │
│     ▶ https://x.com      ← Click this   │
│                                         │
│ Name          Value                     │
│ auth_token    abc123...  ← Copy this    │
│ ct0           xyz789...  ← Copy this    │
└─────────────────────────────────────────┘

Firefox

1. Open https://x.com
2. Press F12
3. Click Storage tab (not "Application")
4. Expand Cookies → https://x.com
5. Copy auth_token and ct0 values

Safari

1. Enable Developer menu:

- Safari → Preferences → Advanced - Check "Show Develop menu in menu bar"

1. Go to https://x.com
2. Develop → Show Web Inspector
3. Storage tab → Cookies → x.com
4. Copy auth_token and ct0

⚠️ Important Security Notes

• These cookies are like your password - they give full access to your X account
• Never share them with anyone
• Don't post them online or commit them to git
• They're stored locally in .env with strict permissions (600 = only you can read)
• They expire periodically - you'll need to update them (the skill will tell you)

The setup wizard creates a .env file that looks like this:

AUTH_TOKEN=your_long_token_here
CT0=your_other_token_here

---

🛠️ Requirements

Required

• Node.js v16+ (download here)
• bird CLI - X/Twitter command-line tool

```bash npm install -g bird ```

Optional (but recommended)

• PM2 - For running as a background daemon

```bash npm install -g pm2 ```

The setup wizard checks all of this automatically!

---

⚙️ Configuration

After running npm run setup, you'll have two files:

1. .env - Your Credentials

AUTH_TOKEN=your_token_here
CT0=your_ct0_here

Never commit this file! It's in .gitignore.

2. config.json - Your Preferences

{
  "credentialsFile": ".env",
  "bookmarkCount": 50,
  "checkIntervalMinutes": 60,
  "storageDir": "../../life/resources/bookmarks",
  "notifyTelegram": true,
  "contextProjects": [
    "trading bot",
    "agent memory",
    "your other projects..."
  ]
}

Key settings:

• bookmarkCount - How many recent bookmarks to check (default: 50)
• checkIntervalMinutes - How often to check for new bookmarks (default: 60)
• contextProjects - Your active projects - the more specific, the better the AI analysis!
• notifyTelegram - Get notified about high-value insights (requires OpenClaw)

You can edit config.json anytime. Changes take effect on next run.

---

🚀 Usage

Run Once (Process Current Bookmarks)

npm start

Processes your recent bookmarks once and exits.

Test Mode (See What Would Happen)

npm test

Shows what it would process without actually doing it.

Background Daemon (Recommended for Daily Use)

npm run daemon

This runs Bookmark Intelligence in the background, checking for new bookmarks every hour (configurable).

Managing the daemon:

pm2 status bookmark-intelligence   # Check if it's running
pm2 logs bookmark-intelligence     # View recent logs
pm2 stop bookmark-intelligence     # Pause it
pm2 restart bookmark-intelligence  # Restart it
pm2 delete bookmark-intelligence   # Remove it completely

---

📂 Where Does Everything Go?

skills/bookmark-intelligence/
├── .env                    # Your credentials (SECRET - never commit!)
├── config.json             # Your preferences
├── bookmarks.json          # Processing state (tracks what's been analyzed)
├── monitor.js              # Main script
├── analyzer.js             # AI analysis engine
├── scripts/
│   ├── setup.js           # Setup wizard
│   └── uninstall.js       # Clean uninstall
└── examples/              # Sample outputs to show you what to expect

...