Vox Pop

LLMは教科書に書かれていることを知っています。
これは、人々が実際にどう考えているかを伝えます。

9つのプラットフォーム • セマンティックルーティング • LLMインテリジェンスレイヤー • APIキーなしで動作

インストール • クイックスタート • プラットフォーム • ルーティングの仕組み • MCPサーバー • Claude Codeプラグイン • ロードマップ

なぜ？

> 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)

★ 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.

インストール

pip install vox-pop

以上です。9つのプラットフォームすべてが、APIキーなしで利用できます。オプションのLLMキーを使うと、よりスマートなルーティングを利用できます（ルーティングの仕組みを参照）。

クイックスタート

CLI — 1つのコマンドで9つのプラットフォームすべてを検索します：

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

視点モード — 意見が時間とともにどのように変化したかを確認します：

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

この変化が物語っています：2017年は炎上合戦でした。2026年は分野に特化した実用主義です。

標準検索 — すべてのプラットフォームの結果をフラットに表示します：

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 — 独自のツールに組み込めます：

import asyncio
from 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())

トークンも OAuth も、レート制限のわずらわしさもありません。ステータスは希望的観測ではなく、実際に計測されています — vox-pop platforms --check を実行すると、ライブエンドポイントに対して再チェックします。

Reddit と Lobsters は現在ブロックされています。 どちらも Anubis の プルーフ・オブ・ワークのインタースティシャルの背後にあり、コンテンツの代わりに チャレンジページを表示します。これは設定の問題ではなく、ヘッダーを変更しても回避できません。Reddit の サポートは公式 OAuth API に移行中です。Lobsters は空の結果を返すのではなく、 ブロックされたことを明示的に報告するようになりました。

	プラットフォーム	ステータス	ソース	時間フィルター	スレッド
	HackerNews	動作中	Algolia Search API	あり	あり
	Reddit	ブロック中	Pullpush + Arctic Shift + Redlib のフォールバック	あり	—
	4chan	動作中	公式 JSON API（2012 年以降）	—	あり
	Stack Exchange	動作中	公式 API — 180 以上のコミュニティ	あり	あり
	Telegram	最近の投稿のみ	公開チャンネルのウェブプレビュー（t.me/s/）	—	—
	Lobsters	ブロック中	lobste.rs の JSON API + 検索スクレイピング	あり	—
	Lemmy	動作中	公開 REST API — フェデレーションされたインスタンス	あり	あり
	LessWrong	動作中	GraphQL API	あり	あり
	XenForo Forums	不安定	HTML スクレイピング（Head-Fi、AnandTech など）	—	—

ルーティングの仕組み

クエリは一語でも、段落でも、D&D のルールに関するエッセイほど長い質問でもかまいません。vox-pop は4 段階のルーティングシステムですべてに対応します。

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 は Perplexity／ChatGPT Search のように動作します — LLM が会話形式のクエリを明確な検索文字列に書き換え、適切なコミュニティを選びます。有効にするには、以下の環境変数のいずれかを設定します。

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

Tier 3 は API キーなしで完全にローカル実行されます。33MB の埋め込みモデルが、「生き物に対する矛盾した呪文の挙動」がテーブルトップ RPG のルールを意味すると理解します — 共通のキーワードは一切必要ありません。初回実行時に、4chan のすべてのボードと Stack Exchange のサイトを動的に取得して、すべてを埋め込み、ディスクにキャッシュします。

設定は不要です。 LLM キーが設定されていれば Tier 2 が使われます。設定されていない場合は Tier 3 が処理します。fastembed がインストールされていない場合も、Tier 4（広範検索）は引き続き利用できます。

Claude Code、Cursor、Windsurf、および MCP 互換のすべてのクライアントで動作します。

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

LLM は 4 つのツールを利用できます。

routing_hints パラメーターを使うと、呼び出し元の LLM が検索対象を正確に指定できます。

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

ヒントが指定されていない場合は、ルーティングシステムが自動で処理します。

Claude Code プラグイン

claude plugin add /path/to/vox-pop

実際の意見が役立つ質問をすると、このスキルが自動的に起動します。自然な言葉で質問するだけです。

> "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

手動で検索する場合：/vox-search "your query"

アーキテクチャ

┌──────────────────────────────────────────────────────────┐
│  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         │  │
│  └────────────────────────────────────────────────────┘  │
└──────────────────────────────────────────────────────────┘

各プロバイダーは自動フォールバックを実装しています。1 つのソースがダウンした場合、次のソースが試されます。Reddit には、3 つのフォールバックソースがあります（Pullpush → Arctic Shift → Redlib）。

ロードマップ

コントリビューション

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

セキュリティ