# Send Bookmark Intelligence to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "bookmark-intelligence",
    "name": "Bookmark Intelligence",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/bkrigmo1/bookmark-intelligence",
    "canonicalUrl": "https://clawhub.ai/bkrigmo1/bookmark-intelligence",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/bookmark-intelligence",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bookmark-intelligence",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      ".gitignore",
      "analyzer.js",
      "CLAWHUB_CHECKLIST.md",
      "CLAWHUB_LISTING.md",
      "config.example.json",
      "ecosystem.config.js"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "bookmark-intelligence",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T03:32:26.594Z",
      "expiresAt": "2026-05-07T03:32:26.594Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bookmark-intelligence",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bookmark-intelligence",
        "contentDisposition": "attachment; filename=\"bookmark-intelligence-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "bookmark-intelligence"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/bookmark-intelligence"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/bookmark-intelligence",
    "downloadUrl": "https://openagent3.xyz/downloads/bookmark-intelligence",
    "agentUrl": "https://openagent3.xyz/skills/bookmark-intelligence/agent",
    "manifestUrl": "https://openagent3.xyz/skills/bookmark-intelligence/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/bookmark-intelligence/agent.md"
  }
}
```
## Documentation

### 🔖 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

Check your current tier:
npm run license:check



View upgrade options:
npm run license:upgrade



Choose payment method:

Credit Card (Stripe)
Crypto (USDC on Polygon)



Activate your license:
node scripts/license.js activate YOUR-LICENSE-KEY

### 📋 Quick Start

Total setup time: ~5 minutes

Run the setup wizard:
cd skills/bookmark-intelligence
npm run setup



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



Run it once to process your current bookmarks:
npm start



Set it up as a background daemon (optional but recommended):
npm run daemon

That's it! You're done. 🎉

### 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:

Monitors your X bookmarks automatically
Fetches the full content from any linked articles (not just the tweets)
Analyzes everything with AI to extract key concepts and actionable items
Relates insights to YOUR specific projects and interests
Notifies you (via Telegram) when it finds something valuable
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

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

Expand Cookies
Click https://x.com


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

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

### Safari

Enable Developer menu:

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


Go to https://x.com
Develop → Show Web Inspector
Storage tab → Cookies → x.com
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

### Required

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

### Optional (but recommended)

PM2 - For running as a background daemon
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.

### 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

life/resources/bookmarks/   # ← Analyzed bookmarks saved here
├── bookmark-123.json
├── bookmark-456.json
└── ...

Each analyzed bookmark becomes a JSON file with:

The original tweet (author, text, engagement stats)
Full analysis (summary, key concepts, actionable items)
Implementation suggestions for YOUR projects
Priority level
Timestamp

### 🔔 Notifications (OpenClaw Integration)

If you're running this inside OpenClaw (not standalone), you can get Telegram notifications for high-value insights.

What triggers a notification:

priority: "high" AND
hasActionableInsights: true

What you get:

📚 Summary of the content
🎯 List of actionable items
💡 Key concepts
🔨 Implementation suggestions for your projects
🔗 Link to the original tweet

See examples/sample-notification.md for a full example.

### 🧹 Uninstalling

npm run uninstall

This will:

Stop the PM2 daemon (if running)
Delete your credentials (.env)
Delete configuration (config.json)
Delete processing state (bookmarks.json)
Ask if you want to keep your analyzed bookmarks

To reinstall later, just run npm run setup again.

### "Missing Twitter credentials" error

Problem: The skill can't find your auth tokens.

Solution:

Make sure you ran npm run setup
Check that .env exists in skills/bookmark-intelligence/
Check that .env has both AUTH_TOKEN= and CT0= lines

### "No bookmarks fetched" or "unauthorized" error

Problem: Your cookies are invalid or expired.

Solution:

Get fresh cookies from X.com (see instructions above)
Update .env with new values
Try running npm test to verify

To manually test your credentials:

cd skills/bookmark-intelligence
source .env
bird whoami --json

If this works, your credentials are valid.

### "bird: command not found"

Problem: bird CLI isn't installed.

Solution:

npm install -g bird

### Daemon not running / stops unexpectedly

Problem: PM2 might not be installed, or daemon crashed.

Solution:

# Check PM2 is installed
pm2 --version

# If not, install it
npm install -g pm2

# Check daemon status
pm2 status

# View logs to see what happened
pm2 logs bookmark-intelligence

# Restart
npm run daemon

### Analysis seems generic / not relevant

Problem: The AI doesn't know what you care about.

Solution:

Edit config.json
Update contextProjects with specific project descriptions:
"contextProjects": [
  "Building a crypto trading bot using Python and Binance API",
  "Learning Rust for systems programming",
  "Growing my SaaS to $10k MRR"
]


Restart: pm2 restart bookmark-intelligence

The more specific you are, the better the AI can relate insights to your work!

### 🔐 Privacy & Data

Where is your data stored?

Credentials: .env (local file, permissions: 600)
Analyzed bookmarks: life/resources/bookmarks/ (local files)
Nothing is sent to any third party except:

X.com (to fetch your bookmarks)
OpenAI/Anthropic (for AI analysis, if using OpenClaw LLM)
Linked websites (to fetch article content)

Can I use this without OpenClaw?

Yes! It works standalone
You won't get LLM analysis (falls back to keyword-based analysis)
You won't get Telegram notifications
Everything else works fine

Is it safe?

Your credentials never leave your machine
.env is in .gitignore so you won't accidentally commit it
File permissions are set to 600 (owner read/write only)
No telemetry, no phone-home

### 🎨 Customization Ideas

Once you're comfortable with the basics, you can customize:

### Change notification threshold

Edit monitor.js line ~120 to notify on medium priority too:

if (config.notifyTelegram && (analysis.priority === 'high' || analysis.priority === 'medium')) {

### Process more bookmarks

Edit config.json:

{
  "bookmarkCount": 100  // Check last 100 bookmarks
}

### Check more frequently

{
  "checkIntervalMinutes": 30  // Check every 30 minutes
}

### Export to Notion / Obsidian

Add your own export script in scripts/export-to-notion.js - each bookmark is already a clean JSON structure!

### 📚 Examples

See the examples/ folder:

sample-analysis.json - What a full analysis looks like
sample-notification.md - What you'll see in Telegram

### 🐛 Found a Bug?

Open an issue on ClawHub or submit a PR!

Common issues:

Cookie expiration → Just update .env with fresh cookies
Rate limiting → Reduce bookmarkCount or increase checkIntervalMinutes
Analysis quality → Make contextProjects more specific

### 📜 License

MIT - Do whatever you want with it!

### Accepted Payment Methods

Credit Card (Stripe)

All major credit cards accepted
Instant activation
Automatic recurring billing
Cancel anytime

Cryptocurrency

USDC on Polygon network
Low transaction fees (~$0.01)
Manual verification (24hr activation)
Send exact amount with payment ID as memo

### How Payments Work

Run npm run license:upgrade to see options
Choose your tier and payment method
For Stripe: Click the link and complete checkout
For Crypto: Send USDC to the provided address with the payment memo
You'll receive a license key via email
Activate: node scripts/license.js activate <key>

### License Management

Check your status anytime:

npm run license:check

Your license includes:

Subscription tier and features
Usage stats (bookmarks processed this month)
Expiration date
Grace period (3 days after expiration)

Renewals:

Monthly: Auto-renews every 30 days
Annual: Auto-renews every 365 days
You'll receive renewal reminders via email

### Refund Policy

30-day money-back guarantee for annual plans
Monthly subscriptions: Refund available within 7 days of first payment
Contact support with your license key or payment ID
Refunds processed within 5-7 business days

### Privacy

Payment processing: Stripe (PCI-DSS Level 1 certified)
We never store your credit card details
License keys are encrypted locally on your machine
Usage statistics are stored locally only

### Support

Free Tier: Community support via GitHub issues
Pro Tier: Email support (48hr response time)
Enterprise Tier: Priority support (8hr response time) + Slack channel

### General

Q: Do I need OpenClaw to use this?
A: No! It works standalone. With OpenClaw you get LLM analysis and notifications, but it's optional.

Q: Can I try it before paying?
A: Yes! Start with the Free tier (10 bookmarks/month). No credit card required.

Q: How do I upgrade or downgrade?
A: Run npm run license:upgrade to upgrade. For downgrades, contact support before renewal.

Q: What happens if I exceed my Free tier limit?
A: Processing stops at 10 bookmarks. You'll see a message prompting you to upgrade. Your data is safe.

### Billing

Q: Can I cancel anytime?
A: Yes! No commitments. Cancel before your next billing date and you won't be charged.

Q: Do you offer discounts?
A: Annual plans save 2 months (16% off). Student/nonprofit discounts available - contact support.

Q: What if my payment fails?
A: You'll get a 3-day grace period to update payment info. After that, you'll downgrade to Free tier.

Q: Can I get an invoice?
A: Yes! Invoices are emailed automatically. Enterprise customers can request custom invoices.

### Technical

Q: Does the Free tier use AI analysis?
A: No, Free tier uses keyword-based heuristics. Upgrade to Pro for full AI-powered insights.

Q: How does automation work?
A: Pro/Enterprise tiers can run as a background daemon (PM2) that checks bookmarks automatically.

Q: Can I use my own AI API keys?
A: Enterprise tier only. Supports OpenAI, Anthropic, and custom endpoints.

Q: Is my data private?
A: Yes! Everything runs locally. Your bookmarks never leave your machine except for AI analysis API calls.

Q: What if I change machines?
A: Your license key works on one machine at a time. Contact support to transfer licenses.

### For Sellers (if distributing via ClawHub)

Q: How do I configure payment for my wallet?
A: Edit payment-config.json and add your Stripe keys and/or crypto wallet address.

Q: Can I change the pricing?
A: Yes! Edit the pricing section in payment-config.json.

Q: How do I issue trial licenses?
A: Use the admin dashboard: node scripts/admin.js issue pro user@example.com trial

Q: How do I track revenue?
A: Run npm run admin:revenue to see stats.

### 🤝 Contributing

Pull requests welcome! Areas for improvement:

Better content extraction (handle paywalls, PDFs, etc.)
Deduplication (don't re-analyze similar bookmarks)
Trend detection (spot recurring themes across bookmarks)
Interactive Telegram UI (implement/dismiss/save for later buttons)
Export integrations (Notion, Obsidian, Roam)

Made with ❤️ for OpenClaw

Questions? Check the troubleshooting section above or ask in the OpenClaw community!
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: bkrigmo1
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-30T03:32:26.594Z
- Expires at: 2026-05-07T03:32:26.594Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/bookmark-intelligence)
- [Send to Agent page](https://openagent3.xyz/skills/bookmark-intelligence/agent)
- [JSON manifest](https://openagent3.xyz/skills/bookmark-intelligence/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/bookmark-intelligence/agent.md)
- [Download page](https://openagent3.xyz/downloads/bookmark-intelligence)