Skip to content

Latest commit

 

History

History
373 lines (255 loc) · 20 KB

File metadata and controls

373 lines (255 loc) · 20 KB

Discover content truly worth your time.
BestBlogs is an AI-powered personal reading assistant.

It judges what's worth reading, helps you read faster and deeper, and learns your preferences over time. Natively supports RSS, Newsletter, Twitter, YouTube, and Podcast — bridging a bilingual (Chinese/English) quality pool. Over 20,000 registered users and growing.

v2.4.0 highlights: Your first personalized Pro brief arrives within 15 minutes after activation. Paste a link to auto-detect and add YouTube, Xiaoyuzhou, or WeChat sources. My Reading and My Follows are now unified into a streamlined workspace.

World Cup Special is live: concise match context, recaps, and curated reading help you catch up before and after matches.

🚀 Try BestBlogs.dev →  ·  📬 Subscribe Newsletter  ·  ⭐ Try Pro (7-day free)  ·  中文

Homepage


1. Why BestBlogs

If you've ever subscribed to 200 RSS feeds but dread opening your reader every day, these three kinds of fatigue will sound familiar:

Pain point with self-managed RSS BestBlogs response
Information overload: 200+ articles a day, impossible to keep up AI filters at the source with six-dimensional scoring — only high-scoring content surfaces each day
Can't find the good stuff: clickbait, reposts, machine-translated spam all mixed in AI pre-screening + editorial curation forms a shared quality pool — everyone benefits from the same signal
No signal on depth: no way to tell what's worth a slow read Every piece gets scored across Topic / Content / Depth / Practicality / Innovation / Expression
Language barrier: English originals are hard; waiting for Chinese summaries means delay and distortion Bidirectional immersive translation + AI reading copilot — read originals directly
Repetitive coverage: the same story washed across five feeds Topic pages aggregate fragments into a panoramic view across four lenses: Event / Domain / Person / Product Comparison

BestBlogs doesn't promise more content. It promises content more suited to you.


2. What It Is

BestBlogs.dev is an AI-powered personal reading assistant. The product has two sides:

  • Public Curation Layer — high-quality content curated for all visitors, no login required
  • My Space — a personalized reading flow for logged-in and Pro users

Both are powered by the same shared quality pool (AI pre-screening + editorial curation).

Core Features

Public Curation Layer (available to everyone, no login)

Feature Description
Daily Brief Bilingual (Chinese/English) digest + 10–15 min podcast (Apple / Spotify / Xiaoyuzhou) + distributed via poster, Telegram, X, and RSS
Featured Weekly A weekly hand-curated collection of the most valuable content, refined further from the public quality pool
Topic Pages Editorial deep-dives around key events, domains, people, and product comparisons — fragments assembled into a full-picture view
Explore The main browsing hub for all public BestBlogs content — "Featured / Latest" dual views, no personalization

My Space (login required; Pro unlocks the full workflow)

Feature Description
My Brief Personalized daily digest (text + email) based on your follows, interest tags, and reading behavior — Pro only; first brief arrives within 15 min of Pro activation
My Follows Three-column workspace for five source types (RSS / Newsletter / Twitter / YouTube / Podcast); paste a URL to auto-detect and add YouTube, Xiaoyuzhou, or WeChat sources
My Reading AI reading copilot (summary / translation / Q&A / chapter navigation) + library (bookmarks / highlights / history) — all in one unified page
My Review An evening recap page that organizes your day's reading footprint into a daily reading summary — Pro only

Cross-feature Capabilities

Capability Description
AI Content Analysis Six-dimensional scoring (Topic / Content / Depth / Practicality / Innovation / Expression) + summary + key insights + quotes
Immersive Translation Bidirectional Chinese ↔ English, across articles / tweets / podcasts / videos
Explainable Profile Interests driven by explicit behavior (follows, reading, domain-level custom counts) — no manual weight tuning

Screenshots

Public Curation Layer

Daily Brief

Explore

Topic Pages

My Space (Pro)

My Brief

My Follows


3. Free vs Pro

Free is a complete, standalone high-quality reading product. Pro is the full personal reading assistant workflow.

Feature Free Pro
Full Public Curation Layer
Daily Brief / Featured Weekly / Topic Pages / Explore
My Brief (personalized) ✅ Text + email, daily delivery
My Review ✅ Evening reading summary
Custom Views ✅ Filter by topic / tag / source
Source follow limit Capped 10× higher
AI Reading Copilot 3/day 30/day (10×)
Immersive Translation 3/day 30/day (10×)
Basic Reading Library (bookmarks / highlights / history)
OpenAPI v2

Pro Trial: 7 days free for new users, 14 days for returning users — full access to the personal reading assistant workflow → Start Free Trial

Quotas are adjusted dynamically by the backend. BestBlogs has no aggressive upgrade popups or forced upsells — the motivation to upgrade comes from actually hitting the ceiling on capabilities you use.


4. Quick Start

Browse directly: Visit bestblogs.dev — all public content is free to read.

Command line (for developers and AI agents):

npm install -g @bestblogs/cli
bestblogs auth login           # Enter your API Key (generate in Settings)
bestblogs discover today       # Today's most worth-reading content
bestblogs read deep <id>       # Deep-read one article

Agent Skills (Claude Code / Codex / Cursor, etc.):

npx @bestblogs/skills           # Install all Skills in one step
# After install, just say: "What's worth reading on BestBlogs today?"

5. Newsletter

Every Friday, the Featured Weekly Newsletter delivers a hand-curated collection of the week's best content — AI pre-screened and editorially refined, available as text, email, annotated read, and podcast → Browse past issues

Featured Weekly


6. RSS Feeds

BestBlogs.dev offers flexible RSS subscriptions:

Scope URL
All content https://www.bestblogs.dev/zh/feeds/rss
Featured only https://www.bestblogs.dev/zh/feeds/rss?featured=y
Programming articles https://www.bestblogs.dev/zh/feeds/rss?category=programming&type=article
High-score AI content (English) https://www.bestblogs.dev/en/feeds/rss?category=ai&minScore=90
Featured Weekly (Newsletter) https://www.bestblogs.dev/zh/feeds/rss/newsletter
Daily Brief https://www.bestblogs.dev/zh/feeds/rss/daily-brief

Full parameter reference: BestBlogs_RSS_Doc.md

BestBlogs Quality Pool OPML

OPML files of the sources currently tracked by BestBlogs — import into any RSS reader:

💡 After importing, try following these sources on BestBlogs.dev — let the AI filter them for you. The question isn't "what did I subscribe to?" but "what's actually worth reading?"

Curated Source Collection (opml/)

The BestBlogs team is systematically curating high-quality RSS sources by type. 551 sources are published so far (375 WeChat + 57 podcasts + 119 YouTube channels), with more types coming — stay tuned.

Published so far:

File Type Count Notes
opml/bestblogs_wechat2rss_opml_all.opml WeChat Public Accounts 375 RSS via wechat2rss; companion post
opml/bestblogs_podcast_opml_all.opml Podcasts (Xiaoyuzhou) 57 Xiaoyuzhou podcast RSS; companion post
opml/bestblogs_youtube_opml_all.opml YouTube 119 YouTube channel RSS; companion post

Have a quality RSS source to recommend? Open an Issue.


7. OpenAPI v2

BestBlogs v2 API is open to developers, providing content discovery, reading, and personal data management.

Base URL: https://api.bestblogs.dev/openapi/v2
Auth: Header X-API-KEY: <your_key> (generate in Settings)

Module Description
openapi/01-auth.md Authentication and identity, common conventions
openapi/02-intake.md Interest profile setup, cold-start onboarding
openapi/03-discover.md Content discovery: briefs / recommendations / search
openapi/04-read.md Content reading: full text / Markdown / metadata
openapi/05-capture.md Bookmarks / highlight notes / reading history
Topics GET /openapi/v2/topics (list) + GET /openapi/v2/topics/{slug} (detail, with four typed fields, references, and further reading) — same auth; standalone docs in progress

Typical flow: Auth → Intake (build profile) → Discover (find content) → Read (deep read) → Capture (save notes)

v1 API is deprecated. Historical docs: archive/v1-openapi.md


8. CLI & Agent Skills

@bestblogs/cli

The official command-line tool, built on OpenAPI v2. All commands support --json for direct AI agent consumption.

npm install -g @bestblogs/cli
bestblogs auth login
bestblogs intake setup           # Cold start: pick interest tags
bestblogs discover today --limit 20
bestblogs read deep <resourceId>
bestblogs capture bookmark add <resourceId> --note "Worth re-reading"

BestBlogs Skills

A set of SKILL.md files that let Claude Code, Codex, Cursor, OpenClaw, and other agents actively invoke BestBlogs capabilities (25 stable primitives).

npx @bestblogs/skills             # Install to Claude Code and Codex by default
npx @bestblogs/skills --client codex
npx @bestblogs/skills upgrade     # Upgrade to the latest version

After install, just say:

  • "What's worth reading today?" → bestblogs-discover

  • "Deep-read this article" → bestblogs-read

  • "Bookmark this with a note" → bestblogs-capture

  • "Why was this recommended to me?" → bestblogs-explain

  • "Show me BestBlogs topic pages / show topic X" → bestblogs-topic

  • Docs: skills/README.md

  • Install guide: skills/INSTALL.md

  • Source: skills/


9. Build in Public

BestBlogs is built entirely in public. Here are some behind-the-scenes posts on product decisions and technical implementation:

Post Date Summary
BestBlogs 2.0 Beta: Building a Reading Product That Actually Fits Me Apr 2026 What the v2.0 beta launch taught me about what the product should really solve
Why BestBlogs Is Going Agent Native Apr 2026 Opening OpenAPI / CLI / Skills: organizing reading capabilities into composable workflow primitives
Inside the BestBlogs Daily Brief AI System Mar 2026 How the AI agent workflow behind the daily brief actually works — Skills, Agents, and automation
AI Content Analysis with Dify Workflow at BestBlogs.dev Jul 2024 Full walkthrough: from article pre-screening to deep analysis to multilingual translation
BestBlogs Source Curation Vol. 1: WeChat Public Accounts Jun 2026 375 actively updated WeChat public account RSS feeds, organized by category
BestBlogs Source Curation Vol. 2: Podcasts & Videos Jun 2026 57 Xiaoyuzhou podcasts + 119 YouTube channels, organized by category

10. Docs & Resources

Product and Technical Docs

Document Description
docs/1-VISION.md Vision and long-term direction
docs/2-PRODUCT.md Product strategy, capability matrix, execution roadmap
docs/3-BRAND.md Brand guidelines and expression standards
docs/4-ARCHITECTURE.md System boundaries, technical pipeline, and feature flags
docs/5-DESIGN.md Visual and interaction guidelines
docs/6-UI-SPEC.md UI component and interaction specs
docs/7-CONVENTIONS.md Development conventions and code style
docs/8-CURRENT_STATE.md Current state, milestones, and roadmap
docs/9-TESTING.md Test layering and coverage requirements
docs/10-TERMINOLOGY.md Chinese/English terminology reference
docs/11-OPERATIONS.md Operations, monitoring, and rollback SOP
docs/12-WORKFLOW.md Development workflow overview

Version History

Full bilingual changelogs in changelog/ (from v2.0.0). Each minor release (v2.x.0) is also published as a GitHub Release.

Roadmap & Community

Historical Archive

archive/ contains v1 API docs, early Dify implementation documents, and other historical materials for reference only.


11. How It Works

AI Content Processing Pipeline

RSS crawl → pre-filter → AI deep analysis → multilingual translation → index → personalized recommendation

1. Content Crawl: RSS + headless browser full-text extraction; sources support custom CSS selectors.

2. Pre-filter: Language detection, quality signal scoring, filtering of low-value content.

3. AI Deep Analysis: LLM generates six-dimensional scores + summary + key insights + quotes + tags.

4. Multilingual Translation: Terminology detection → initial translation → review → idiomatic refinement; bilingual Chinese/English.

5. Personalized Recommendation: Six-dimensional interest tag matching + daily brief intelligent curation.

Detailed implementation docs and Dify DSLs:


12. Community & Support

Alongside the podcast and YouTube source curation, we've also organized BestBlogs' public channels for community and updates.

If you're interested in RSS, AI-powered reading, agent workflows, high-quality sources, or personal knowledge management, follow BestBlogs here:

Channel Description
WeChat Group Day-to-day chat, feedback, and source recommendations; if the QR code expires, add ginobot on WeChat to join
WeChat Official Account Product updates, source curation, and reading tips → Follow
Feishu Group Deeper product, engineering, and ops discussions → Join
Xiaoyuzhou (Chinese) Chinese daily brief, curated picks, and product news → Listen
Xiaoyuzhou (English) English curated content and BestBlogs updates → Listen
Apple Podcasts For listeners who prefer Apple Podcasts → Subscribe
Public Repo OPML, source lists, OpenAPI, CLI, and Agent skills → BestBlogs on GitHub
Author's Blog Product iteration, architecture, growth, and indie dev notes → GinoNotes
Gino on X BestBlogs, AI reading, RSS, agents, and indie dev → @hongming731
Xiaoguang on X Product, content, community, startups, and reading experience → @puliandc

If BestBlogs.dev has been useful to you:

Support the project            WeChat group (contact ginobot if QR expired)
Support BestBlogs Join WeChat group

Acknowledgements

Thanks to the following open-source projects:

  • RSSHub — RSS for everything
  • wechat2rss — WeChat public accounts → RSS
  • Dify — LLM application development platform
  • XGo.ing — Twitter/X RSS feeds
  • Bark — iOS push notifications
  • Uptime Kuma — self-hosted monitoring