Skip to main content
TikRSS
Official User Manual & Guides

Everything You Need to Master TikRSS

From capturing your first video link to configuring Obsidian vaults and Telegram bots, master the full workflow in 5 minutes.

Chapter 01

30-Second Quick Start

No complex setup required. Start your very first distillation directly from the home console:

Step 1: Paste any link into the search box
  • YouTube video URL or channel handle (@creator)
  • TikTok user profile URL (@handle)
  • Open podcast RSS feed link
Step 2: Instant preview & structured recap

Click "Start briefing". The engine captures the full transcript and structures your TL;DR, claims, and key takeaways within 10 seconds.

Chapter 02

Capture Channels Setup

Telegram Bot (@TikRssBot)

The most friction-free mobile habit: forward video links directly to our Telegram bot.

  1. Search @TikRssBot in Telegram and hit /start.
  2. Bind your account token via /bind <your_token>.
  3. Share any video to the bot; it immediately confirms queue status for tomorrow.
1-Click Browser Bookmarklet
Zero Bloat · All Browsers

A bookmarklet is a lightweight, 1-click subscription tool that lives directly in your browser’s bookmarks bar:

  • ⚡No Extension

    No Chrome Web Store install or background processes. Zero browser bloat.

  • 🌐Universal Support

    Works natively across Chrome, Safari, Edge, Arc, Brave, and Firefox.

  • 🎯1-Click Instant

    Browse any video, click the bookmark, and the creator is queued for tomorrow.

Three-Step Setup & Usage:
  1. Navigate to Settings → Import, enter a device label (e.g., MacBook Chrome), and click Generate Token.
  2. Show your bookmarks bar (Cmd+Shift+B or Ctrl+Shift+B), then drag the "Track in TikRSS" button to your bookmarks bar.
  3. When watching any video on YouTube or TikTok, click the bookmarklet once to subscribe and queue the creator into your daily digest.
Email Forwarding Subscriptions

Pro and Power subscribers receive a unique intake address ({hash}@in.tikrss.com). Set up Gmail filters to auto-forward your favorite newsletters for autonomous video parsing.

OPML / CSV Bulk Import

Migrating from YouTube Takeout, Feedly, or Inoreader? Bulk import your subscriptions in seconds:

  1. Export your subscriptions OPML file from Google Takeout or your RSS reader.
  2. Navigate to Settings → Import and drop your .opml or .csv file.
  3. TikRSS automatically resolves creator handles. Select your feeds and click Confirm Import.
Daily Email Briefing & Markdown Export

Your digest lands in your inbox every day at your chosen time (per your timezone). Prefer local reading? Every summary exports as clean Markdown:

Open any video dossier and click Download MD / Copy MD, or batch-export everything from Settings → Exports into Obsidian / Notion.
Chapter 03

Obsidian & Notion Auto-Sync

Obsidian Local Vault Setup

Navigate to Settings → Exports and enter your absolute local Vault directory path.

Exports cleanly formatted Markdown with metadata: author, timestamp, tags, and [[bidirectional]] wikilinks.
Notion Database OAuth

Click Connect with Notion, authorize database access, and let TikRSS populate properties (Cover, Author, Summary, Key Quotes) automatically.

Chapter 04

Customization & Tuning

Domain-Specific Prompt Templates

Power tier users can configure distinct prompt styles per category:

  • Finance / Macro: Focus on liquidity metrics, valuation multiples, and risk factors.
  • Tech / AI: Extract model architectures, inference compute scaling, and repo links.
  • Health / Longevity: Anchor to biological biomarkers (ApoB, VO2 max) and clinical evidence.
Delivery Time & Timezone

Default delivery is 07:00 in your local timezone. Adjust to 06:00 or 08:30 inside Settings → Preferences.

Chapter 05

AI Agents & Terminal CLI Setup

TikRSS provides an official Model Context Protocol (MCP) server and terminal CLI. Configure in 30 seconds to empower Claude Desktop and Cursor with real-time video intelligence.

1Obtain your TikRSS API Key

Navigate to Settings → Account, generate or copy your Bearer API token (starts with tr_live_...).

2Configure Claude Desktop MCP

Open claude_desktop_config.json (on macOS: ~/Library/Application Support/Claude/claude_desktop_config.json) and add:

{
  "mcpServers": {
    "tikrss": {
      "command": "npx",
      "args": ["-y", "@tikrss/mcp-server"],
      "env": {
        "TIKRSS_API_KEY": "tr_live_••••••••"
      }
    }
  }
}

Restart Claude Desktop. The hammer tool icon will appear with 5 native tools available.

3Install and Use Terminal CLI

Install the unified CLI globally via npm to manage your feeds straight from the terminal:

$ npm install -g tikrss
$ tikrss login --token tr_live_••••••••
$ tikrss today
$ tikrss add https://youtube.com/@karpathy
$ tikrss search "reasoning scaling"
$ tikrss export <video-id> --out ./briefing.md
Open source on GitHub (MIT License)
ericx0/tikrss-cli ↗
Chapter 06

Troubleshooting & FAQ

What if the video has no official uploaded captions?

TikRSS automatically generates a full transcript with high precision and specialized terminology correction, even when no captions are uploaded.

Which plan is required for MCP Server and CLI access?

The official MCP server, Terminal CLI, and REST API are exclusive to Power tier subscribers. Requests made with Free or Pro tokens receive a 403 upgrade response.

Will bulk importing OPML exceed my creator quota?

During import preview, TikRSS displays your current active slots vs plan limits (Free: 3, Pro: 50, Power: Unlimited). You selectively pick which creators to track.

How are dense technical terminology and foreign languages handled?

Our synthesis prompts leverage specialized ontologies in computer science, biotech, and macroeconomics. It also cross-translates across 12 languages directly into your preferred native tongue.

What happens to my exported notes if I cancel my subscription?

They remain yours forever. We enforce a zero vendor lock-in guarantee: all Markdown files written to your Obsidian vault or Notion workspace remain intact and accessible indefinitely.

Can I swap creators when I hit my tracking quota?

Yes, you can pause or unfollow creators anytime inside Following settings to immediately free up tracking slots for new feeds.

Still have questions?

Our team responds within 1 business day.

Contact Support →