Zulook

🚀 zulook

Zulipの会話に対する読み取り専用アクセスを提供します。CLI、MCPサーバー、またはACPプロキシとして動作します。

ZulipのURLを入力すると、メッセージが返されます。これだけです。

$ zulook https://rust-lang.zulipchat.com/#narrow/stream/213817-t-lang/topic/test

Messages from t-lang > test:

**Alice** (2025-01-15 14:32 UTC) [test]
Has anyone looked at the new RFC?

**Bob** (2025-01-15 14:35 UTC) [test]
Yes, I left some comments on the thread.

Older: https://rust-lang.zulipchat.com/#narrow/channel/213817-t-lang/topic/test/near/12340
Newer: https://rust-lang.zulipchat.com/#narrow/channel/213817-t-lang/topic/test/near/12345

🚀 クイックスタート

📦 インストール

ZulipのAPIキーが必要です。最も簡単な方法は以下の通りです。

1. Zulipインスタンスにログインします。
2. 個人設定 > アカウントとプライバシーに移動します。
3. APIキーの管理をクリックし、パスワードを入力します。
4. .zuliprcをダウンロードをクリックします。
5. それを~/zuliprcに移動します。

   mv ~/Downloads/.zuliprc ~/zuliprc
   

設定ファイルのパスはzulip-terminalの規則に従います：~/zuliprc（ドットなし）。

または、環境変数を設定することもできます。

export ZULIP_URL=https://your-org.zulipchat.com
export ZULIP_EMAIL=you@example.com
export ZULIP_API_KEY=your_api_key

💻 使用例

基本的な使用法

CLI

zulook <url> [limit=N]

任意のZulip URL（ストリーム、トピック、DM、グループDM、/near/アンカー付きまたはなし）を渡します。デフォルトのメッセージ制限は100件です。

# ストリームトピック
zulook https://rust-lang.zulipchat.com/#narrow/stream/213817-t-lang/topic/test

# DM会話
zulook https://rust-lang.zulipchat.com/#narrow/dm/116009,116107-dm/near/572348733

# メッセージ数を減らす
zulook https://rust-lang.zulipchat.com/#narrow/stream/213817-t-lang/topic/test limit=20

出力には、履歴をページングするためのOlderとNewerのURLが含まれます。

MCPサーバー

zulook mcp

標準入出力を介してMCPサーバーとして実行します。単一のzulipツールを公開します — URLまたは"help"を渡します。

Claude Codeの設定（~/.claude/settings.json）：

{
  "mcpServers": {
    "zulook": {
      "command": "/path/to/zulook",
      "args": ["mcp"]
    }
  }
}

ACPプロキシ

zulook acp

標準入出力を介してACPプロキシとして実行し、ACPコンダクターとともに使用します。

🔧 技術詳細

zulookは、ZulipのナローURLを解析して、URLフラグメントからストリーム/チャンネル、トピック、DM参加者、およびメッセージアンカーを抽出します。その後、対応するナローフィルターでZulip REST API（GET /api/v1/messages）を呼び出し、整形されたメッセージを返します。

URLが唯一のインターフェースです。1つのツール、1つのコマンドパターンがあり、ページネーションはURLをたどるだけです — ブラウザで見るのと同じURLです。

🛠️ ビルド方法

cargo build --release

Rust 2024エディションが必要です。