Vox Pop

io.github.mushfique-dgist由 GitHub 帳號 mushfique-dgist 發布v0.2.0更新於 Oct 25, 2026

Search 9 public discussion platforms for real opinions. Semantic routing, no API keys required.

已驗證STDIO僅桌面網頁搜尋與抓取知識與記憶AI 與機器學習

概覽

AI 產生的概覽

Vox Pop 搜尋 9 個公開討論平台，以找出有關主題的真實意見，提供超越標準搜尋結果的背景資訊。

可以做什麼
在公開討論平台上搜尋主題的真實意見。提供主題的歷史和最新觀點。深入特定討論串的評論以獲得更深入的見解。列出所有可用且健康的討論平台。
適用情境
當您想知道人們對某個主題的真實看法，而不僅僅是正式文章或教科書上的內容時使用。它非常適合評估小眾或有爭議話題的輿論趨勢。
執行需求
作為本地程序運行（PyPI 套件）。可將 LLM 金鑰（ANTHROPIC_API_KEY, OPENAI_API_KEY, OLLAMA_HOST）設為環境變數以啟用更智慧的路由。
安裝前請注意
此工具會存取公開討論平台。雖然它聲稱僅使用公開資料，但請留意論壇和社群平台內容的性質。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Vox Pop，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README


[VOX-POP]

Your LLM knows what textbooks say.
This tells it what people actually think.

9 platforms • Semantic routing • LLM intelligence layer • Works without API keys

[License: MIT] [Python 3.10+] [MCP Compatible] [No Keys Required]

Install • Quick Start • Platforms • How Routing Works • MCP Server • Claude Code Plugin • Roadmap


Why?

Without vox-pop

> How do I debloat my face?
Lymphatic drainage, reduce sodium,cold compress, drink water,sleep elevated...
(correct but soulless — same answer as every health blog since 2015)

With vox-pop

★ Searched: Reddit, 4chan /fit/, SE Fitness
Consensus (70%+ of threads): → Reduce sodium + 3L water/day → Sleep elevated on back
Controversial: → Gua sha: loved on Reddit,   mocked on /fit/ as placebo
What actually worked: → "Cut dairy for 2 weeks — face    visibly deflated" (847↑ r/SCA) → "Minox bloat is real, went away    month 3" (/fit/, recurring)
⚠ Some suggestions are unvetted.

Install

bash
pip install vox-pop

That's it. All 9 platforms work with zero API keys. Optional LLM key unlocks smarter routing (see How Routing Works).


Quick Start

CLI — search all 9 platforms in one command:

bash
vox-pop search "should I learn Rust or Go"

Perspective mode — see how opinions evolved over time:

bash
vox-pop search "rust vs go" --perspective --platforms hackernews,reddit
## hackernews — Then vs Now
Historical (1+ year ago):> "Rust vs. Go"  — hackernews | +481 points | 580 replies | 2017-01-18
Recent (last 6 months):> "Rust vs. Go: Memory Management"  — hackernews | +2 points | 2025-11-15
## reddit — Then vs Now
Historical:> "Experienced developer but total beginner in Rust..."  — reddit | +124 points | 34 replies | 2025-03-14
Recent:> "I rebuilt the same API in Java, Go, Kotlin, and Rust — here are the numbers"  — reddit | +174 points | 59 replies | 2026-03-19

The shift tells a story: 2017 was a flame war. 2026 is domain-specific pragmatism.

Standard search — flat results from all platforms:

bash
vox-pop search "should I learn Rust or Go" --limit 3
### hackernews (45 found)> "I am a full stack TypeScript dev looking to broaden my skill set..."  — hackernews | +78 points | 42 replies | by throwaway_dev  Source: https://news.ycombinator.com/item?id=41907717
### 4chan /g/ (12 found)> "Rust is a mass psychosis. Go is boring but you'll actually ship..."  — 4chan /g/ | 129 replies | by Anonymous
### reddit (8 found)> "After 2 years with both: Rust for systems, Go for services..."  — reddit | +234 points | 87 replies | by senior_dev_42

Python — embed in your own tools:

python
import asynciofrom vox_pop.core import search_multiple, format_context, get_default_providers
async def main():    results = await search_multiple(        "best laptop for programming",        providers=get_default_providers(),    )    print(format_context(results))
asyncio.run(main())

Platforms

No tokens, no OAuth, no rate-limit headaches. Status is measured, not aspirational — vox-pop platforms --check re-runs this against live endpoints.

Reddit and Lobsters are currently blocked. Both sit behind Anubis proof-of-work interstitials that serve a challenge page instead of content. This is not a configuration issue and no header change defeats it. Reddit support is being moved to the official OAuth API; Lobsters now reports the block explicitly rather than returning an empty result.

PlatformStatusSourceTime FilterThreads
[HN]HackerNewsWorkingAlgolia Search APIYesYes
[Reddit]RedditBlockedPullpush + Arctic Shift + Redlib fallbackYes—
[4chan]4chanWorkingOfficial JSON API (since 2012)—Yes
[SE]Stack ExchangeWorkingOfficial API — 180+ communitiesYesYes
[TG]TelegramRecent onlyPublic channel web preview (t.me/s/)——
[Lobsters]LobstersBlockedlobste.rs JSON API + search scrapingYes—
[Lemmy]LemmyWorkingPublic REST API — federated instancesYesYes
[LW]LessWrongWorkingGraphQL APIYesYes
[Forums]XenForo ForumsFlakyHTML scraping (Head-Fi, AnandTech, etc.)——

How Routing Works

Queries can be anything — a single word, a paragraph, an essay-length D&D rules question. vox-pop understands them all through a four-tier routing system:

User query: "i was looking into a solid laptop for linux             something from hp, what would a savvy person pick"                                    │    ┌───────────────────────────────▼──────────────────────────────┐    │  Tier 1: MCP Hints                                           │    │  Calling LLM provides routing_hints directly                 │    │  (skips all other tiers)                                     │    ├──────────────────────────────────────────────────────────────┤    │  Tier 2: LLM Query Rewrite          ← like Perplexity        │    │  Cheap LLM call rewrites query to search-optimized form      │    │  "hp laptop linux compatibility" + routes to communities     │    │  Supports: Anthropic, OpenAI, Ollama (local/free)            │    ├──────────────────────────────────────────────────────────────┤    │  Tier 3: Semantic Embeddings         ← free, no API key      │    │  FastEmbed (33MB model) understands meaning, not keywords    │    │  Dynamic catalog: 77 4chan boards + 180 SE sites + static    │    │  "contradictory spell behaviour" → SE:rpg, r/DnD, /tg/       │    ├──────────────────────────────────────────────────────────────┤    │  Tier 4: Broad Defaults                                      │    │  Search popular destinations everywhere                      │    └──────────────────────────────────────────────────────────────┘                                    │                                    ▼    Routes to: r/buildapc, r/linux, r/hardware │ /g/               SE:hardwarerecs, SE:askubuntu │ lemmy:[email protected]

Tier 2 works like Perplexity/ChatGPT Search — the LLM rewrites your conversational query into a clean search string and picks the right communities. Set any of these env vars to enable:

bash
ANTHROPIC_API_KEY=...   # Uses Claude Haiku (~$0.0003/query)OPENAI_API_KEY=...      # Uses GPT-4o MiniOLLAMA_HOST=...         # Uses local Ollama (free)

Tier 3 runs entirely locally with zero API keys. A 33MB embedding model understands that "contradictory spell behaviour on a creature" means tabletop RPG rules — zero shared keywords needed. On first run, it fetches all 4chan boards and Stack Exchange sites dynamically, embeds everything, and caches to disk.

Cold startWarm startSingleton
Tier 3 timing~7s~1.3sinstant

No configuration needed. If an LLM key is set, Tier 2 is used. Otherwise Tier 3 handles it. If fastembed isn't installed, Tier 4 (broad search) still works.

Routing examples
QueryRoutes to
"best hp laptop for linux"r/buildapc, r/linux, r/hardware, /g/, SE:hardwarerecs, SE:askubuntu
"contradictory spell effects on a creature"r/dndnext, r/DnD, /tg/, SE:rpg
"best mechanical keyboard for programming"r/MechanicalKeyboards, /g/, SE:hardwarerecs
"what are the risks of yield farming"r/CryptoCurrency, SE:tezos, telegram:ethereum
"how to make authentic kimchi jjigae"r/Cooking, /ck/

MCP Server

Works with Claude Code, Cursor, Windsurf, and any MCP-compatible client.

json
{  "mcpServers": {    "vox-pop": {      "command": "python",      "args": ["-m", "vox_pop.server"]    }  }}

Your LLM gets four tools:

ToolWhat it does
search_opinionsSearch all platforms for opinions on a topic
search_opinions_perspectiveThen vs Now — historical + recent opinions side by side
get_thread_opinionsDive into a specific thread's comments
list_available_platformsCheck what's available and healthy

The routing_hints parameter lets the calling LLM specify exactly where to search:

routing_hints: "reddit:MechanicalKeyboards,4chan:g,stackexchange:hardwarerecs"

When no hints are provided, the routing system handles it automatically.


Claude Code Plugin

bash
claude plugin add /path/to/vox-pop

The skill auto-triggers when your question would benefit from real opinions. Just ask naturally:

> "What do people think about living in Berlin?"    → activates> "Should I use Next.js or Remix?"                  → activates> "Best gym routine for beginners?"                 → activates> "What's the capital of France?"                   → does not activate

Manual search: /vox-search "your query"


Architecture

┌──────────────────────────────────────────────────────────┐│  Layer 3: Claude Code / MCP Client                       ││  Auto-triggering skill + /vox-search                     │├──────────────────────────────────────────────────────────┤│  Layer 2: MCP Server                                     ││  search_opinions · perspectives · threads · list         │├──────────────────────────────────────────────────────────┤│  Layer 1: Python Library                                 ││  ┌────────────────────────────────────────────────────┐  ││  │  Smart Router (4-tier)                             │  ││  │  MCP hints → LLM rewrite → FastEmbed → broad      │  ││  └────────────────────────────────────────────────────┘  ││  ┌────────────────────────────────────────────────────┐  ││  │  9 Providers with fallback chains                  │  ││  │  HN · Reddit · 4chan · SE · Telegram               │  ││  │  Lobsters · Lemmy · LessWrong · XenForo Forums     │  ││  └────────────────────────────────────────────────────┘  ││  ┌────────────────────────────────────────────────────┐  ││  │  Dynamic Catalog                                   │  ││  │  77 4chan boards + 180 SE sites fetched from APIs   │  ││  │  + 120 static destinations · cached to disk         │  ││  └────────────────────────────────────────────────────┘  │└──────────────────────────────────────────────────────────┘

Each provider implements automatic fallback — if one source is down, the next is tried. Reddit alone has three fallback sources (Pullpush → Arctic Shift → Redlib).


Roadmap

VersionStatusWhat
v0.1Shipped5 providers (HN, Reddit, 4chan, SE, Telegram), MCP server, Claude Code plugin
v0.2Current9 providers, 4-tier smart routing, LLM query rewriting, FastEmbed semantic routing, dynamic catalog
v0.3In progressReddit via official OAuth API — replaces the blocked Redlib path
v0.4Not startedRegional — DC Inside (Korea), Naver, 5ch (Japan)

Contributing

New provider?          → Subclass Provider in src/vox_pop/providers/base.pyNew routing destination → Add to DESTINATIONS in router.py (one line)Dynamic catalog source → Add a _fetch_*_destinations() function in router.pyBetter LLM prompt?     → Improve _LLM_SYSTEM in router.pyMultilingual support?  → Swap FastEmbed model to bge-m3 in SemanticRouterDead instance?         → Open an issue with the instance URLRegional platform?     → DC Inside, Naver, 5ch, VK, Bilibili — all welcome

Security

Data accessPublic data only — official APIs and public web endpoints. No login-wall scraping.
CredentialsZero stored. Optional LLM keys passed via env vars at runtime, never written to disk.
LLM routingWhen ANTHROPIC_API_KEY or OPENAI_API_KEY is set, your query text (up to 4000 chars) is sent to the respective LLM API for routing only. No queries are sent externally without an explicit API key. Without keys, routing runs entirely locally via FastEmbed.
Rate limitsRespected per-platform. Built-in concurrency guards.
User-AgentTransparent: vox-pop/0.2 in all requests.
CachingAPI responses (7 days) and embeddings cached locally at ~/.cache/vox-pop/. No data sent to third parties. Embeddings stored as JSON, no serialization dependencies.
PIIAuthor names from public posts included for attribution only. Never stored beyond the response.

vox populi, vox dei
the voice of the people is the voice of god


MIT License

來源：README.md，提交 d10b757

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分