Skip to content

felixsim/bookmark-brain

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🧠 bookmark-brain

bookmark-brain hero

Your AI reads your Twitter/X bookmarks. You get business ideas.

Stop hoarding tweets you'll never act on.

Bookmark-brain is an OpenClaw agent skill that watches a designated Twitter/X bookmark folder, reads each tweet in full (threads, linked articles, videos), and delivers a structured business opportunity analysis β€” revenue model, launch workflow, personalised founder angle, and recommended action β€” straight to your Telegram.

Built for founders who save tweets but rarely revisit them.


The Problem

You save 5 tweets a day. Smart ones. Frameworks, business models, indie hacker wins, niche ideas.

Then you forget them.

Your bookmarks folder is a graveyard of good intentions. You check it once a month, scroll for 90 seconds, close it.

Bookmark-brain fixes this. Your AI agent reads every bookmarked tweet the moment you save it, turns it into a decision-ready analysis, and delivers it to you on Telegram.


What It Does

  1. Watches a dedicated bookmark folder β€” you create a folder called For Review (or anything you like). Drop tweets in it. That's your signal.

  2. Reads the full content β€” expands threads, follows links, reads articles. Never analyses from the 280-character preview.

  3. Runs structured business analysis β€” for each tweet, it produces:

    • πŸ“Š Revenue model (unit economics, pricing, market size)
    • πŸš€ Launch workflow (step-by-step, week-by-week)
    • πŸ›  Tools & stack
    • ⚠️ Risk assessment
    • 🎯 Founder-specific angle (why it fits you)
    • βœ… Recommended action (build / research / skip)
  4. Delivers to Telegram β€” one message per bookmark, so you can reply inline ("build this", "skip", "remind me in 2 weeks")

  5. Moves processed bookmarks β€” from For Review to Processed, so you always know what's been analyzed


Demo

Input (tweet saved to bookmark folder):

"Built a micro-CRM for vet clinics in a weekend. $10K MRR in 6 months. The trick: niche CRMs for underserved verticals have no real competition. Here's the framework..."

Output (delivered to Telegram):

πŸ”– @codyschneiderxx

**Summary:** Build industry-specific micro CRMs for verticals where existing tools are overkill. Vet clinics, music studios, tattoo shops β€” verticals with 10K-100K businesses, no budget for Salesforce, but revenue to support a $50-150/mo SaaS.

**Revenue Model:**
- SaaS subscription: $49-149/mo per business
- Unit economics: $99/mo avg Γ— 24mo retention = $2,376 LTV
- CAC via cold email + SEO: ~$200 β†’ 12:1 LTV:CAC
- Market: 100K+ underserved verticals in the US alone

**Launch Workflow:**
1. Week 1: Pick one vertical (start with what you know)
2. Week 1-2: 10 cold DMs β€” "what CRM do you use?" β€” validate in 48 hrs
3. Week 2-3: Build with Cursor AI + Supabase (stripped-down CRM, 5 features max)
4. Week 4: 5 free beta users from your outreach list
5. Week 6: Start charging $49/mo
6. Month 3: SEO campaign targeting "best CRM for [vertical]" vs competitors

**Tools:** Next.js + Supabase + Stripe + Resend. Total build cost: ~$0 beyond time.
**Timeline:** MVP in 2 weeks. First revenue in 6 weeks.

**Risks:**
- Vertical too small β†’ pick one with 10K+ businesses
- Churn if you build wrong features β†’ validate before coding

**Founder Angle:** You have domain knowledge in [your industry]. That's the moat. Build the CRM for the people you already know. Your network = instant distribution.

**Recommended action:** βœ… BUILD β€” validate first with 10 DMs, commit to one vertical

Setup

Requirements

  • OpenClaw with a configured agent
  • Twitter/X account with X Premium (required for bookmark folders)
  • Telegram bot configured in OpenClaw (or Slack / WhatsApp / Discord)

Install

Just tell your agent:

Review and install this OpenClaw skill: https://github.com/felixsim/bookmark-brain

Before installing, read the repo's SKILL.md, README, and LICENSE. Tell me what it does, what files it will create or modify in my workspace, and whether it needs any API keys or external services.

Check for conflicts β€” do I already have a skill with the same name or similar purpose? Will it modify files I depend on (MEMORY.md, AGENTS.md, anything in memory/)? Are there any commands in SKILL.md that look risky (network calls, credential access, file deletions without backups)?

If anything looks wrong, stop and show me the exact lines. Otherwise, give me your assessment and wait for my approval before installing.

Install only β€” do NOT run or activate the skill yet. I'll decide when to use it.

Your agent reads the repo, audits it for safety, checks your workspace for conflicts, and asks for your go-ahead before touching anything. No blind installs.

Rollback: Delete the skills/bookmark-brain/ folder from your workspace. Nothing else is modified.

Configure

After installing, open SKILL.md in your workspace and update the placeholders:

Placeholder Replace with
YOUR_BOOKMARK_FOLDER Your bookmark folder name (e.g. For Review)
YOUR_TELEGRAM_CHAT_ID Your Telegram chat or group ID
YOUR_THREAD_ID Your Telegram thread ID (if using topics)
YOUR_OUTPUT_DIR Where to write JSON artifacts (e.g. ~/bookmark-runs/)

Twitter Bookmark Folder

  1. Go to x.com/i/bookmarks
  2. Click "Add new folder" β†’ name it For Review (or your preferred name)
  3. When you save a tweet you want analyzed, move it to this folder

Tweets in the default "All Bookmarks" are ignored.


How It Works

Twitter/X bookmark folder
        β”‚
        β–Ό
  Agent opens browser β†’ reads each tweet in full
        β”‚
        β–Ό
  Analysis framework runs (revenue / launch / risks / founder angle)
        β”‚
        β”œβ”€β”€β”€ JSON artifact written to output dir
        β”‚
        └─── Telegram message delivered (one per bookmark)
                β”‚
                β–Ό
        Bookmark moved to "Processed" folder

Analysis Framework

For business opportunities, the agent uses this lens:

  1. Revenue model β€” How does this make money? Unit economics, pricing, market size.
  2. Launch workflow β€” What are the concrete first steps? Week-by-week to first revenue.
  3. Tools & stack β€” What to build with. Defaults to lean, AI-assisted tools.
  4. Risk assessment β€” What could kill this? How to mitigate.
  5. Founder angle β€” Why does this fit you? Unfair advantages, path to automation.
  6. Recommended action β€” Build / Research further / Skip.

For non-business content (industry insights, frameworks, technical threads), it produces a lighter summary with key takeaways and why it's relevant.


Cron (Automated)

Run on a schedule with OpenClaw's cron feature:

Every 60 minutes: review bookmark folder, skip if empty, skip if run <45 min ago

Add to your agent config:

{
  "cron": "*/60 * * * *",
  "task": "review bookmark-brain skill"
}

Privacy

This skill runs entirely on your machine via your own OpenClaw instance. No data is sent to any third-party service. The only external calls are:

  • Twitter/X β€” via your authenticated browser session (read-only)
  • Telegram β€” to deliver the analysis to you
  • Any linked articles β€” fetched via browser to read full content

No analytics. No telemetry. No API keys required beyond your existing OpenClaw setup.


Customising the Analysis

Edit SKILL.md to change:

  • Folder name β€” watch a different bookmark folder
  • Founder context β€” add your industry, skills, and business context so the agent tailors its "founder angle" to you
  • Analysis depth β€” adjust time-boxing per bookmark (default: 5 min max)
  • Output format β€” modify the Telegram message template
  • Skip rules β€” change what gets analyzed vs silently skipped (memes, duplicates, etc.)

Comparison

Bookmark-brain Manual review Generic AI summary
Reads full thread + links βœ… πŸ˜“ Usually skipped ❌ Preview only
Revenue model analysis βœ… If you remember ❌ Generic
Founder-specific angle βœ… Personalised βœ… If you're good ❌ Generic
Automated delivery βœ… Telegram ❌ You have to open it ❌
Moves to Processed βœ… ❌ ❌
Runs on your machine βœ… N/A ❌ Cloud

FAQ

Does it analyze every bookmark I save? Only bookmarks in the designated folder (e.g. For Review). Your main bookmark list is untouched.

What if a link is paywalled? It analyzes from the tweet thread and notes the limitation. Paywalled content gets a lighter analysis.

What if the tweet is just a meme? It skips detailed analysis, moves to Processed, logs "type": "entertainment". No noise in your Telegram.

Can I use a different output channel instead of Telegram? Yes β€” the skill sends via OpenClaw's message tool, which supports WhatsApp, Slack, Discord, and more. Edit the channel config in SKILL.md.

Does it work with X Premium bookmark folders? Yes β€” bookmark folders are an X Premium feature. This skill requires you have them enabled.

How often does it run? Default: every 60 minutes. Skips if the folder is empty or if it ran less than 45 minutes ago.


Examples

See the examples/ directory:


Rollback

To uninstall: delete skills/bookmark-brain/ from your workspace. Nothing else is modified. The skill does not touch your MEMORY.md, AGENTS.md, or any other workspace files.


Related

  • bonsai-memory β€” Reduce your agent's memory token usage by 70-95%

License

MIT β€” free to use, modify, and distribute.

Built by Felix Sim as a free contribution to the OpenClaw community.

About

🧠 Your AI reads your Twitter/X bookmarks. You get business ideas. OpenClaw skill for automated bookmark review and opportunity analysis.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors