{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/bookmark-intelligence",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bookmark-intelligence",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      ".gitignore",
      "analyzer.js",
      "CLAWHUB_CHECKLIST.md",
      "CLAWHUB_LISTING.md",
      "config.example.json",
      "ecosystem.config.js"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/bookmark-intelligence",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "🔖 Bookmark Intelligence",
        "body": "Turn your X (Twitter) bookmarks into actionable insights, automatically.\n\nBookmark 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."
      },
      {
        "title": "💎 Pricing & Tiers",
        "body": "Bookmark Intelligence offers three tiers to fit your needs:"
      },
      {
        "title": "🆓 Free Tier",
        "body": "Perfect for trying it out\n\nPrice: $0/month\n10 bookmarks per month\nManual run only (no automation)\nBasic keyword analysis (no AI)\nNo notifications\nRate limited: 1 run per hour"
      },
      {
        "title": "⭐ Pro Tier - $9/month",
        "body": "Best for individuals\n\nUnlimited bookmarks\nAutomated monitoring (background daemon)\nFull AI-powered analysis (GPT-4o-mini)\nTelegram notifications\nPriority support"
      },
      {
        "title": "🚀 Enterprise Tier - $29/month",
        "body": "For teams and power users\n\nEverything in Pro, plus:\nTeam sharing & collaboration\nCustom AI models (bring your own API keys)\nAPI access for integrations\nSlack & Discord notifications\nWebhook support\nDedicated support\n\nAnnual plans available - Save 2 months (16% off)!"
      },
      {
        "title": "How to Upgrade",
        "body": "Check your current tier:\nnpm run license:check\n\n\n\nView upgrade options:\nnpm run license:upgrade\n\n\n\nChoose payment method:\n\nCredit Card (Stripe)\nCrypto (USDC on Polygon)\n\n\n\nActivate your license:\nnode scripts/license.js activate YOUR-LICENSE-KEY"
      },
      {
        "title": "📋 Quick Start",
        "body": "Total setup time: ~5 minutes\n\nRun the setup wizard:\ncd skills/bookmark-intelligence\nnpm run setup\n\n\n\nThe wizard will:\n\n✅ Check if you have the required tools installed\n🍪 Guide you through getting your X cookies (step-by-step)\n🎯 Ask about your active projects & interests\n⚙️ Configure notification preferences\n🧪 Test your credentials\n\n\n\nRun it once to process your current bookmarks:\nnpm start\n\n\n\nSet it up as a background daemon (optional but recommended):\nnpm run daemon\n\nThat's it! You're done. 🎉"
      },
      {
        "title": "The Problem",
        "body": "You bookmark tons of great content on X, but:\n\nYou never go back to read it\nThe tweets link to articles you don't have time to read\nYou forget why you bookmarked something\nYou miss connections to your current projects"
      },
      {
        "title": "The Solution",
        "body": "Bookmark Intelligence:\n\nMonitors your X bookmarks automatically\nFetches the full content from any linked articles (not just the tweets)\nAnalyzes everything with AI to extract key concepts and actionable items\nRelates insights to YOUR specific projects and interests\nNotifies you (via Telegram) when it finds something valuable\nStores everything in a searchable knowledge base"
      },
      {
        "title": "Example Output",
        "body": "You bookmark a tweet about \"vector embeddings for AI memory\" → The skill:\n\nFetches the linked article\nExtracts: key concepts, actionable implementation steps, code patterns\nRelates it to your \"trading bot\" and \"agent memory\" projects\nSuggests: \"Store market analysis as embeddings to find historical patterns\"\nSaves the full analysis to life/resources/bookmarks/bookmark-123.json\nSends you a Telegram notification with the summary\n\nSee examples/sample-analysis.json for a full example."
      },
      {
        "title": "🍪 Getting Your X Cookies (Step-by-Step)",
        "body": "You need two cookies from X.com. Don't worry, this is safe and takes 2 minutes."
      },
      {
        "title": "Chrome / Edge / Brave",
        "body": "Open https://x.com in your browser\nMake sure you're logged in\nPress F12 (opens Developer Tools)\nClick the Application tab at the top\nIn the left sidebar:\n\nExpand Cookies\nClick https://x.com\n\n\nYou'll see a list of cookies. Find these two:\n\nauth_token → Copy the Value column\nct0 → Copy the Value column\n\n┌─────────────────────────────────────────┐\n│ Application  Console  Sources  ...     │ ← Click \"Application\"\n├─────────────────────────────────────────┤\n│ ▼ Storage                               │\n│   ▼ Cookies                             │\n│     ▶ https://x.com      ← Click this   │\n│                                         │\n│ Name          Value                     │\n│ auth_token    abc123...  ← Copy this    │\n│ ct0           xyz789...  ← Copy this    │\n└─────────────────────────────────────────┘"
      },
      {
        "title": "Firefox",
        "body": "Open https://x.com\nPress F12\nClick Storage tab (not \"Application\")\nExpand Cookies → https://x.com\nCopy auth_token and ct0 values"
      },
      {
        "title": "Safari",
        "body": "Enable Developer menu:\n\nSafari → Preferences → Advanced\nCheck \"Show Develop menu in menu bar\"\n\n\nGo to https://x.com\nDevelop → Show Web Inspector\nStorage tab → Cookies → x.com\nCopy auth_token and ct0"
      },
      {
        "title": "⚠️ Important Security Notes",
        "body": "These cookies are like your password - they give full access to your X account\nNever share them with anyone\nDon't post them online or commit them to git\nThey're stored locally in .env with strict permissions (600 = only you can read)\nThey expire periodically - you'll need to update them (the skill will tell you)\n\nThe setup wizard creates a .env file that looks like this:\n\nAUTH_TOKEN=your_long_token_here\nCT0=your_other_token_here"
      },
      {
        "title": "Required",
        "body": "Node.js v16+ (download here)\nbird CLI - X/Twitter command-line tool\nnpm install -g bird"
      },
      {
        "title": "Optional (but recommended)",
        "body": "PM2 - For running as a background daemon\nnpm install -g pm2\n\nThe setup wizard checks all of this automatically!"
      },
      {
        "title": "⚙️ Configuration",
        "body": "After running npm run setup, you'll have two files:"
      },
      {
        "title": "1. .env - Your Credentials",
        "body": "AUTH_TOKEN=your_token_here\nCT0=your_ct0_here\n\nNever commit this file! It's in .gitignore."
      },
      {
        "title": "2. config.json - Your Preferences",
        "body": "{\n  \"credentialsFile\": \".env\",\n  \"bookmarkCount\": 50,\n  \"checkIntervalMinutes\": 60,\n  \"storageDir\": \"../../life/resources/bookmarks\",\n  \"notifyTelegram\": true,\n  \"contextProjects\": [\n    \"trading bot\",\n    \"agent memory\",\n    \"your other projects...\"\n  ]\n}\n\nKey settings:\n\nbookmarkCount - How many recent bookmarks to check (default: 50)\ncheckIntervalMinutes - How often to check for new bookmarks (default: 60)\ncontextProjects - Your active projects - the more specific, the better the AI analysis!\nnotifyTelegram - Get notified about high-value insights (requires OpenClaw)\n\nYou can edit config.json anytime. Changes take effect on next run."
      },
      {
        "title": "Run Once (Process Current Bookmarks)",
        "body": "npm start\n\nProcesses your recent bookmarks once and exits."
      },
      {
        "title": "Test Mode (See What Would Happen)",
        "body": "npm test\n\nShows what it would process without actually doing it."
      },
      {
        "title": "Background Daemon (Recommended for Daily Use)",
        "body": "npm run daemon\n\nThis runs Bookmark Intelligence in the background, checking for new bookmarks every hour (configurable).\n\nManaging the daemon:\n\npm2 status bookmark-intelligence   # Check if it's running\npm2 logs bookmark-intelligence     # View recent logs\npm2 stop bookmark-intelligence     # Pause it\npm2 restart bookmark-intelligence  # Restart it\npm2 delete bookmark-intelligence   # Remove it completely"
      },
      {
        "title": "📂 Where Does Everything Go?",
        "body": "skills/bookmark-intelligence/\n├── .env                    # Your credentials (SECRET - never commit!)\n├── config.json             # Your preferences\n├── bookmarks.json          # Processing state (tracks what's been analyzed)\n├── monitor.js              # Main script\n├── analyzer.js             # AI analysis engine\n├── scripts/\n│   ├── setup.js           # Setup wizard\n│   └── uninstall.js       # Clean uninstall\n└── examples/              # Sample outputs to show you what to expect\n\nlife/resources/bookmarks/   # ← Analyzed bookmarks saved here\n├── bookmark-123.json\n├── bookmark-456.json\n└── ...\n\nEach analyzed bookmark becomes a JSON file with:\n\nThe original tweet (author, text, engagement stats)\nFull analysis (summary, key concepts, actionable items)\nImplementation suggestions for YOUR projects\nPriority level\nTimestamp"
      },
      {
        "title": "🔔 Notifications (OpenClaw Integration)",
        "body": "If you're running this inside OpenClaw (not standalone), you can get Telegram notifications for high-value insights.\n\nWhat triggers a notification:\n\npriority: \"high\" AND\nhasActionableInsights: true\n\nWhat you get:\n\n📚 Summary of the content\n🎯 List of actionable items\n💡 Key concepts\n🔨 Implementation suggestions for your projects\n🔗 Link to the original tweet\n\nSee examples/sample-notification.md for a full example."
      },
      {
        "title": "🧹 Uninstalling",
        "body": "npm run uninstall\n\nThis will:\n\nStop the PM2 daemon (if running)\nDelete your credentials (.env)\nDelete configuration (config.json)\nDelete processing state (bookmarks.json)\nAsk if you want to keep your analyzed bookmarks\n\nTo reinstall later, just run npm run setup again."
      },
      {
        "title": "\"Missing Twitter credentials\" error",
        "body": "Problem: The skill can't find your auth tokens.\n\nSolution:\n\nMake sure you ran npm run setup\nCheck that .env exists in skills/bookmark-intelligence/\nCheck that .env has both AUTH_TOKEN= and CT0= lines"
      },
      {
        "title": "\"No bookmarks fetched\" or \"unauthorized\" error",
        "body": "Problem: Your cookies are invalid or expired.\n\nSolution:\n\nGet fresh cookies from X.com (see instructions above)\nUpdate .env with new values\nTry running npm test to verify\n\nTo manually test your credentials:\n\ncd skills/bookmark-intelligence\nsource .env\nbird whoami --json\n\nIf this works, your credentials are valid."
      },
      {
        "title": "\"bird: command not found\"",
        "body": "Problem: bird CLI isn't installed.\n\nSolution:\n\nnpm install -g bird"
      },
      {
        "title": "Daemon not running / stops unexpectedly",
        "body": "Problem: PM2 might not be installed, or daemon crashed.\n\nSolution:\n\n# Check PM2 is installed\npm2 --version\n\n# If not, install it\nnpm install -g pm2\n\n# Check daemon status\npm2 status\n\n# View logs to see what happened\npm2 logs bookmark-intelligence\n\n# Restart\nnpm run daemon"
      },
      {
        "title": "Analysis seems generic / not relevant",
        "body": "Problem: The AI doesn't know what you care about.\n\nSolution:\n\nEdit config.json\nUpdate contextProjects with specific project descriptions:\n\"contextProjects\": [\n  \"Building a crypto trading bot using Python and Binance API\",\n  \"Learning Rust for systems programming\",\n  \"Growing my SaaS to $10k MRR\"\n]\n\n\nRestart: pm2 restart bookmark-intelligence\n\nThe more specific you are, the better the AI can relate insights to your work!"
      },
      {
        "title": "🔐 Privacy & Data",
        "body": "Where is your data stored?\n\nCredentials: .env (local file, permissions: 600)\nAnalyzed bookmarks: life/resources/bookmarks/ (local files)\nNothing is sent to any third party except:\n\nX.com (to fetch your bookmarks)\nOpenAI/Anthropic (for AI analysis, if using OpenClaw LLM)\nLinked websites (to fetch article content)\n\nCan I use this without OpenClaw?\n\nYes! It works standalone\nYou won't get LLM analysis (falls back to keyword-based analysis)\nYou won't get Telegram notifications\nEverything else works fine\n\nIs it safe?\n\nYour credentials never leave your machine\n.env is in .gitignore so you won't accidentally commit it\nFile permissions are set to 600 (owner read/write only)\nNo telemetry, no phone-home"
      },
      {
        "title": "🎨 Customization Ideas",
        "body": "Once you're comfortable with the basics, you can customize:"
      },
      {
        "title": "Change notification threshold",
        "body": "Edit monitor.js line ~120 to notify on medium priority too:\n\nif (config.notifyTelegram && (analysis.priority === 'high' || analysis.priority === 'medium')) {"
      },
      {
        "title": "Process more bookmarks",
        "body": "Edit config.json:\n\n{\n  \"bookmarkCount\": 100  // Check last 100 bookmarks\n}"
      },
      {
        "title": "Check more frequently",
        "body": "{\n  \"checkIntervalMinutes\": 30  // Check every 30 minutes\n}"
      },
      {
        "title": "Export to Notion / Obsidian",
        "body": "Add your own export script in scripts/export-to-notion.js - each bookmark is already a clean JSON structure!"
      },
      {
        "title": "📚 Examples",
        "body": "See the examples/ folder:\n\nsample-analysis.json - What a full analysis looks like\nsample-notification.md - What you'll see in Telegram"
      },
      {
        "title": "🐛 Found a Bug?",
        "body": "Open an issue on ClawHub or submit a PR!\n\nCommon issues:\n\nCookie expiration → Just update .env with fresh cookies\nRate limiting → Reduce bookmarkCount or increase checkIntervalMinutes\nAnalysis quality → Make contextProjects more specific"
      },
      {
        "title": "📜 License",
        "body": "MIT - Do whatever you want with it!"
      },
      {
        "title": "Accepted Payment Methods",
        "body": "Credit Card (Stripe)\n\nAll major credit cards accepted\nInstant activation\nAutomatic recurring billing\nCancel anytime\n\nCryptocurrency\n\nUSDC on Polygon network\nLow transaction fees (~$0.01)\nManual verification (24hr activation)\nSend exact amount with payment ID as memo"
      },
      {
        "title": "How Payments Work",
        "body": "Run npm run license:upgrade to see options\nChoose your tier and payment method\nFor Stripe: Click the link and complete checkout\nFor Crypto: Send USDC to the provided address with the payment memo\nYou'll receive a license key via email\nActivate: node scripts/license.js activate <key>"
      },
      {
        "title": "License Management",
        "body": "Check your status anytime:\n\nnpm run license:check\n\nYour license includes:\n\nSubscription tier and features\nUsage stats (bookmarks processed this month)\nExpiration date\nGrace period (3 days after expiration)\n\nRenewals:\n\nMonthly: Auto-renews every 30 days\nAnnual: Auto-renews every 365 days\nYou'll receive renewal reminders via email"
      },
      {
        "title": "Refund Policy",
        "body": "30-day money-back guarantee for annual plans\nMonthly subscriptions: Refund available within 7 days of first payment\nContact support with your license key or payment ID\nRefunds processed within 5-7 business days"
      },
      {
        "title": "Privacy",
        "body": "Payment processing: Stripe (PCI-DSS Level 1 certified)\nWe never store your credit card details\nLicense keys are encrypted locally on your machine\nUsage statistics are stored locally only"
      },
      {
        "title": "Support",
        "body": "Free Tier: Community support via GitHub issues\nPro Tier: Email support (48hr response time)\nEnterprise Tier: Priority support (8hr response time) + Slack channel"
      },
      {
        "title": "General",
        "body": "Q: Do I need OpenClaw to use this?\nA: No! It works standalone. With OpenClaw you get LLM analysis and notifications, but it's optional.\n\nQ: Can I try it before paying?\nA: Yes! Start with the Free tier (10 bookmarks/month). No credit card required.\n\nQ: How do I upgrade or downgrade?\nA: Run npm run license:upgrade to upgrade. For downgrades, contact support before renewal.\n\nQ: What happens if I exceed my Free tier limit?\nA: Processing stops at 10 bookmarks. You'll see a message prompting you to upgrade. Your data is safe."
      },
      {
        "title": "Billing",
        "body": "Q: Can I cancel anytime?\nA: Yes! No commitments. Cancel before your next billing date and you won't be charged.\n\nQ: Do you offer discounts?\nA: Annual plans save 2 months (16% off). Student/nonprofit discounts available - contact support.\n\nQ: What if my payment fails?\nA: You'll get a 3-day grace period to update payment info. After that, you'll downgrade to Free tier.\n\nQ: Can I get an invoice?\nA: Yes! Invoices are emailed automatically. Enterprise customers can request custom invoices."
      },
      {
        "title": "Technical",
        "body": "Q: Does the Free tier use AI analysis?\nA: No, Free tier uses keyword-based heuristics. Upgrade to Pro for full AI-powered insights.\n\nQ: How does automation work?\nA: Pro/Enterprise tiers can run as a background daemon (PM2) that checks bookmarks automatically.\n\nQ: Can I use my own AI API keys?\nA: Enterprise tier only. Supports OpenAI, Anthropic, and custom endpoints.\n\nQ: Is my data private?\nA: Yes! Everything runs locally. Your bookmarks never leave your machine except for AI analysis API calls.\n\nQ: What if I change machines?\nA: Your license key works on one machine at a time. Contact support to transfer licenses."
      },
      {
        "title": "For Sellers (if distributing via ClawHub)",
        "body": "Q: How do I configure payment for my wallet?\nA: Edit payment-config.json and add your Stripe keys and/or crypto wallet address.\n\nQ: Can I change the pricing?\nA: Yes! Edit the pricing section in payment-config.json.\n\nQ: How do I issue trial licenses?\nA: Use the admin dashboard: node scripts/admin.js issue pro user@example.com trial\n\nQ: How do I track revenue?\nA: Run npm run admin:revenue to see stats."
      },
      {
        "title": "🤝 Contributing",
        "body": "Pull requests welcome! Areas for improvement:\n\nBetter content extraction (handle paywalls, PDFs, etc.)\nDeduplication (don't re-analyze similar bookmarks)\nTrend detection (spot recurring themes across bookmarks)\nInteractive Telegram UI (implement/dismiss/save for later buttons)\nExport integrations (Notion, Obsidian, Roam)\n\nMade with ❤️ for OpenClaw\n\nQuestions? Check the troubleshooting section above or ask in the OpenClaw community!"
      }
    ],
    "body": "🔖 Bookmark Intelligence\n\nTurn your X (Twitter) bookmarks into actionable insights, automatically.\n\nBookmark 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.\n\n💎 Pricing & Tiers\n\nBookmark Intelligence offers three tiers to fit your needs:\n\n🆓 Free Tier\n\nPerfect for trying it out\n\nPrice: $0/month\n10 bookmarks per month\nManual run only (no automation)\nBasic keyword analysis (no AI)\nNo notifications\nRate limited: 1 run per hour\n⭐ Pro Tier - $9/month\n\nBest for individuals\n\nUnlimited bookmarks\nAutomated monitoring (background daemon)\nFull AI-powered analysis (GPT-4o-mini)\nTelegram notifications\nPriority support\n🚀 Enterprise Tier - $29/month\n\nFor teams and power users\n\nEverything in Pro, plus:\nTeam sharing & collaboration\nCustom AI models (bring your own API keys)\nAPI access for integrations\nSlack & Discord notifications\nWebhook support\nDedicated support\n\nAnnual plans available - Save 2 months (16% off)!\n\nHow to Upgrade\n\nCheck your current tier:\n\nnpm run license:check\n\n\nView upgrade options:\n\nnpm run license:upgrade\n\n\nChoose payment method:\n\nCredit Card (Stripe)\nCrypto (USDC on Polygon)\n\nActivate your license:\n\nnode scripts/license.js activate YOUR-LICENSE-KEY\n\n📋 Quick Start\n\nTotal setup time: ~5 minutes\n\nRun the setup wizard:\n\ncd skills/bookmark-intelligence\nnpm run setup\n\n\nThe wizard will:\n\n✅ Check if you have the required tools installed\n🍪 Guide you through getting your X cookies (step-by-step)\n🎯 Ask about your active projects & interests\n⚙️ Configure notification preferences\n🧪 Test your credentials\n\nRun it once to process your current bookmarks:\n\nnpm start\n\n\nSet it up as a background daemon (optional but recommended):\n\nnpm run daemon\n\n\nThat's it! You're done. 🎉\n\n🎯 What It Does\nThe Problem\n\nYou bookmark tons of great content on X, but:\n\nYou never go back to read it\nThe tweets link to articles you don't have time to read\nYou forget why you bookmarked something\nYou miss connections to your current projects\nThe Solution\n\nBookmark Intelligence:\n\nMonitors your X bookmarks automatically\nFetches the full content from any linked articles (not just the tweets)\nAnalyzes everything with AI to extract key concepts and actionable items\nRelates insights to YOUR specific projects and interests\nNotifies you (via Telegram) when it finds something valuable\nStores everything in a searchable knowledge base\nExample Output\n\nYou bookmark a tweet about \"vector embeddings for AI memory\" → The skill:\n\nFetches the linked article\nExtracts: key concepts, actionable implementation steps, code patterns\nRelates it to your \"trading bot\" and \"agent memory\" projects\nSuggests: \"Store market analysis as embeddings to find historical patterns\"\nSaves the full analysis to life/resources/bookmarks/bookmark-123.json\nSends you a Telegram notification with the summary\n\nSee examples/sample-analysis.json for a full example.\n\n🍪 Getting Your X Cookies (Step-by-Step)\n\nYou need two cookies from X.com. Don't worry, this is safe and takes 2 minutes.\n\nChrome / Edge / Brave\nOpen https://x.com in your browser\nMake sure you're logged in\nPress F12 (opens Developer Tools)\nClick the Application tab at the top\nIn the left sidebar:\nExpand Cookies\nClick https://x.com\nYou'll see a list of cookies. Find these two:\nauth_token → Copy the Value column\nct0 → Copy the Value column\n┌─────────────────────────────────────────┐\n│ Application  Console  Sources  ...     │ ← Click \"Application\"\n├─────────────────────────────────────────┤\n│ ▼ Storage                               │\n│   ▼ Cookies                             │\n│     ▶ https://x.com      ← Click this   │\n│                                         │\n│ Name          Value                     │\n│ auth_token    abc123...  ← Copy this    │\n│ ct0           xyz789...  ← Copy this    │\n└─────────────────────────────────────────┘\n\nFirefox\nOpen https://x.com\nPress F12\nClick Storage tab (not \"Application\")\nExpand Cookies → https://x.com\nCopy auth_token and ct0 values\nSafari\nEnable Developer menu:\nSafari → Preferences → Advanced\nCheck \"Show Develop menu in menu bar\"\nGo to https://x.com\nDevelop → Show Web Inspector\nStorage tab → Cookies → x.com\nCopy auth_token and ct0\n⚠️ Important Security Notes\nThese cookies are like your password - they give full access to your X account\nNever share them with anyone\nDon't post them online or commit them to git\nThey're stored locally in .env with strict permissions (600 = only you can read)\nThey expire periodically - you'll need to update them (the skill will tell you)\n\nThe setup wizard creates a .env file that looks like this:\n\nAUTH_TOKEN=your_long_token_here\nCT0=your_other_token_here\n\n🛠️ Requirements\nRequired\nNode.js v16+ (download here)\nbird CLI - X/Twitter command-line tool\nnpm install -g bird\n\nOptional (but recommended)\nPM2 - For running as a background daemon\nnpm install -g pm2\n\n\nThe setup wizard checks all of this automatically!\n\n⚙️ Configuration\n\nAfter running npm run setup, you'll have two files:\n\n1. .env - Your Credentials\nAUTH_TOKEN=your_token_here\nCT0=your_ct0_here\n\n\nNever commit this file! It's in .gitignore.\n\n2. config.json - Your Preferences\n{\n  \"credentialsFile\": \".env\",\n  \"bookmarkCount\": 50,\n  \"checkIntervalMinutes\": 60,\n  \"storageDir\": \"../../life/resources/bookmarks\",\n  \"notifyTelegram\": true,\n  \"contextProjects\": [\n    \"trading bot\",\n    \"agent memory\",\n    \"your other projects...\"\n  ]\n}\n\n\nKey settings:\n\nbookmarkCount - How many recent bookmarks to check (default: 50)\ncheckIntervalMinutes - How often to check for new bookmarks (default: 60)\ncontextProjects - Your active projects - the more specific, the better the AI analysis!\nnotifyTelegram - Get notified about high-value insights (requires OpenClaw)\n\nYou can edit config.json anytime. Changes take effect on next run.\n\n🚀 Usage\nRun Once (Process Current Bookmarks)\nnpm start\n\n\nProcesses your recent bookmarks once and exits.\n\nTest Mode (See What Would Happen)\nnpm test\n\n\nShows what it would process without actually doing it.\n\nBackground Daemon (Recommended for Daily Use)\nnpm run daemon\n\n\nThis runs Bookmark Intelligence in the background, checking for new bookmarks every hour (configurable).\n\nManaging the daemon:\n\npm2 status bookmark-intelligence   # Check if it's running\npm2 logs bookmark-intelligence     # View recent logs\npm2 stop bookmark-intelligence     # Pause it\npm2 restart bookmark-intelligence  # Restart it\npm2 delete bookmark-intelligence   # Remove it completely\n\n📂 Where Does Everything Go?\nskills/bookmark-intelligence/\n├── .env                    # Your credentials (SECRET - never commit!)\n├── config.json             # Your preferences\n├── bookmarks.json          # Processing state (tracks what's been analyzed)\n├── monitor.js              # Main script\n├── analyzer.js             # AI analysis engine\n├── scripts/\n│   ├── setup.js           # Setup wizard\n│   └── uninstall.js       # Clean uninstall\n└── examples/              # Sample outputs to show you what to expect\n\nlife/resources/bookmarks/   # ← Analyzed bookmarks saved here\n├── bookmark-123.json\n├── bookmark-456.json\n└── ...\n\n\nEach analyzed bookmark becomes a JSON file with:\n\nThe original tweet (author, text, engagement stats)\nFull analysis (summary, key concepts, actionable items)\nImplementation suggestions for YOUR projects\nPriority level\nTimestamp\n🔔 Notifications (OpenClaw Integration)\n\nIf you're running this inside OpenClaw (not standalone), you can get Telegram notifications for high-value insights.\n\nWhat triggers a notification:\n\npriority: \"high\" AND\nhasActionableInsights: true\n\nWhat you get:\n\n📚 Summary of the content\n🎯 List of actionable items\n💡 Key concepts\n🔨 Implementation suggestions for your projects\n🔗 Link to the original tweet\n\nSee examples/sample-notification.md for a full example.\n\n🧹 Uninstalling\nnpm run uninstall\n\n\nThis will:\n\nStop the PM2 daemon (if running)\nDelete your credentials (.env)\nDelete configuration (config.json)\nDelete processing state (bookmarks.json)\nAsk if you want to keep your analyzed bookmarks\n\nTo reinstall later, just run npm run setup again.\n\n🔧 Troubleshooting\n\"Missing Twitter credentials\" error\n\nProblem: The skill can't find your auth tokens.\n\nSolution:\n\nMake sure you ran npm run setup\nCheck that .env exists in skills/bookmark-intelligence/\nCheck that .env has both AUTH_TOKEN= and CT0= lines\n\"No bookmarks fetched\" or \"unauthorized\" error\n\nProblem: Your cookies are invalid or expired.\n\nSolution:\n\nGet fresh cookies from X.com (see instructions above)\nUpdate .env with new values\nTry running npm test to verify\n\nTo manually test your credentials:\n\ncd skills/bookmark-intelligence\nsource .env\nbird whoami --json\n\n\nIf this works, your credentials are valid.\n\n\"bird: command not found\"\n\nProblem: bird CLI isn't installed.\n\nSolution:\n\nnpm install -g bird\n\nDaemon not running / stops unexpectedly\n\nProblem: PM2 might not be installed, or daemon crashed.\n\nSolution:\n\n# Check PM2 is installed\npm2 --version\n\n# If not, install it\nnpm install -g pm2\n\n# Check daemon status\npm2 status\n\n# View logs to see what happened\npm2 logs bookmark-intelligence\n\n# Restart\nnpm run daemon\n\nAnalysis seems generic / not relevant\n\nProblem: The AI doesn't know what you care about.\n\nSolution:\n\nEdit config.json\nUpdate contextProjects with specific project descriptions:\n\"contextProjects\": [\n  \"Building a crypto trading bot using Python and Binance API\",\n  \"Learning Rust for systems programming\",\n  \"Growing my SaaS to $10k MRR\"\n]\n\nRestart: pm2 restart bookmark-intelligence\n\nThe more specific you are, the better the AI can relate insights to your work!\n\n🔐 Privacy & Data\n\nWhere is your data stored?\n\nCredentials: .env (local file, permissions: 600)\nAnalyzed bookmarks: life/resources/bookmarks/ (local files)\nNothing is sent to any third party except:\nX.com (to fetch your bookmarks)\nOpenAI/Anthropic (for AI analysis, if using OpenClaw LLM)\nLinked websites (to fetch article content)\n\nCan I use this without OpenClaw?\n\nYes! It works standalone\nYou won't get LLM analysis (falls back to keyword-based analysis)\nYou won't get Telegram notifications\nEverything else works fine\n\nIs it safe?\n\nYour credentials never leave your machine\n.env is in .gitignore so you won't accidentally commit it\nFile permissions are set to 600 (owner read/write only)\nNo telemetry, no phone-home\n🎨 Customization Ideas\n\nOnce you're comfortable with the basics, you can customize:\n\nChange notification threshold\n\nEdit monitor.js line ~120 to notify on medium priority too:\n\nif (config.notifyTelegram && (analysis.priority === 'high' || analysis.priority === 'medium')) {\n\nProcess more bookmarks\n\nEdit config.json:\n\n{\n  \"bookmarkCount\": 100  // Check last 100 bookmarks\n}\n\nCheck more frequently\n{\n  \"checkIntervalMinutes\": 30  // Check every 30 minutes\n}\n\nExport to Notion / Obsidian\n\nAdd your own export script in scripts/export-to-notion.js - each bookmark is already a clean JSON structure!\n\n📚 Examples\n\nSee the examples/ folder:\n\nsample-analysis.json - What a full analysis looks like\nsample-notification.md - What you'll see in Telegram\n🐛 Found a Bug?\n\nOpen an issue on ClawHub or submit a PR!\n\nCommon issues:\n\nCookie expiration → Just update .env with fresh cookies\nRate limiting → Reduce bookmarkCount or increase checkIntervalMinutes\nAnalysis quality → Make contextProjects more specific\n📜 License\n\nMIT - Do whatever you want with it!\n\n💳 Payment & Licensing\nAccepted Payment Methods\n\nCredit Card (Stripe)\n\nAll major credit cards accepted\nInstant activation\nAutomatic recurring billing\nCancel anytime\n\nCryptocurrency\n\nUSDC on Polygon network\nLow transaction fees (~$0.01)\nManual verification (24hr activation)\nSend exact amount with payment ID as memo\nHow Payments Work\nRun npm run license:upgrade to see options\nChoose your tier and payment method\nFor Stripe: Click the link and complete checkout\nFor Crypto: Send USDC to the provided address with the payment memo\nYou'll receive a license key via email\nActivate: node scripts/license.js activate <key>\nLicense Management\n\nCheck your status anytime:\n\nnpm run license:check\n\n\nYour license includes:\n\nSubscription tier and features\nUsage stats (bookmarks processed this month)\nExpiration date\nGrace period (3 days after expiration)\n\nRenewals:\n\nMonthly: Auto-renews every 30 days\nAnnual: Auto-renews every 365 days\nYou'll receive renewal reminders via email\nRefund Policy\n30-day money-back guarantee for annual plans\nMonthly subscriptions: Refund available within 7 days of first payment\nContact support with your license key or payment ID\nRefunds processed within 5-7 business days\nPrivacy\nPayment processing: Stripe (PCI-DSS Level 1 certified)\nWe never store your credit card details\nLicense keys are encrypted locally on your machine\nUsage statistics are stored locally only\nSupport\n\nFree Tier: Community support via GitHub issues Pro Tier: Email support (48hr response time) Enterprise Tier: Priority support (8hr response time) + Slack channel\n\n❓ Frequently Asked Questions\nGeneral\n\nQ: Do I need OpenClaw to use this?\nA: No! It works standalone. With OpenClaw you get LLM analysis and notifications, but it's optional.\n\nQ: Can I try it before paying?\nA: Yes! Start with the Free tier (10 bookmarks/month). No credit card required.\n\nQ: How do I upgrade or downgrade?\nA: Run npm run license:upgrade to upgrade. For downgrades, contact support before renewal.\n\nQ: What happens if I exceed my Free tier limit?\nA: Processing stops at 10 bookmarks. You'll see a message prompting you to upgrade. Your data is safe.\n\nBilling\n\nQ: Can I cancel anytime?\nA: Yes! No commitments. Cancel before your next billing date and you won't be charged.\n\nQ: Do you offer discounts?\nA: Annual plans save 2 months (16% off). Student/nonprofit discounts available - contact support.\n\nQ: What if my payment fails?\nA: You'll get a 3-day grace period to update payment info. After that, you'll downgrade to Free tier.\n\nQ: Can I get an invoice?\nA: Yes! Invoices are emailed automatically. Enterprise customers can request custom invoices.\n\nTechnical\n\nQ: Does the Free tier use AI analysis?\nA: No, Free tier uses keyword-based heuristics. Upgrade to Pro for full AI-powered insights.\n\nQ: How does automation work?\nA: Pro/Enterprise tiers can run as a background daemon (PM2) that checks bookmarks automatically.\n\nQ: Can I use my own AI API keys?\nA: Enterprise tier only. Supports OpenAI, Anthropic, and custom endpoints.\n\nQ: Is my data private?\nA: Yes! Everything runs locally. Your bookmarks never leave your machine except for AI analysis API calls.\n\nQ: What if I change machines?\nA: Your license key works on one machine at a time. Contact support to transfer licenses.\n\nFor Sellers (if distributing via ClawHub)\n\nQ: How do I configure payment for my wallet?\nA: Edit payment-config.json and add your Stripe keys and/or crypto wallet address.\n\nQ: Can I change the pricing?\nA: Yes! Edit the pricing section in payment-config.json.\n\nQ: How do I issue trial licenses?\nA: Use the admin dashboard: node scripts/admin.js issue pro user@example.com trial\n\nQ: How do I track revenue?\nA: Run npm run admin:revenue to see stats.\n\n🤝 Contributing\n\nPull requests welcome! Areas for improvement:\n\nBetter content extraction (handle paywalls, PDFs, etc.)\nDeduplication (don't re-analyze similar bookmarks)\nTrend detection (spot recurring themes across bookmarks)\nInteractive Telegram UI (implement/dismiss/save for later buttons)\nExport integrations (Notion, Obsidian, Roam)\n\nMade with ❤️ for OpenClaw\n\nQuestions? Check the troubleshooting section above or ask in the OpenClaw community!"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/bkrigmo1/bookmark-intelligence",
    "publisherUrl": "https://clawhub.ai/bkrigmo1/bookmark-intelligence",
    "owner": "bkrigmo1",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}