zhihu-cli スキル

前提

• インストール済み：zhihu が PATH に含まれていること（uv tool install pyzhihu-cli / pipx install pyzhihu-cli / pip install pyzhihu-cli）。
• パス：設定とQRコードのパス — Linux/macOS：~/.zhihu-cli/（例：~/.zhihu-cli/cookies.json、~/.zhihu-cli/login_qrcode.png）；Windows：%USERPROFILE%\.zhihu-cli\（例：%USERPROFILE%\.zhihu-cli\cookies.json、%USERPROFILE%\.zhihu-cli\login_qrcode.png）。
• 設定：ログイン状態は上記の cookies.json に保存されます。Cookieをアップロードしたり、会話/ログに書き込んだりしないでください。
• ログイン方法：2種類のみ — QRコードスキャン zhihu login --qrcode、Cookieの貼り付け zhihu login --cookie "z_c0=...; _xsrf=...; d_c0=..."。
• QRコードスキャン時：QRコードは上記のパスの login_qrcode.png に生成されます。OpenClawを使ってユーザーに送信する場合、まずOpenClawの作業ディレクトリのmediaフォルダにコピーしてから openclaw message send --media <media パス> を実行する必要があります。

Instruction Scope

本スキルは、ユーザーのローカルマシンにインストールされた zhihu コマンドを呼び出し、検索、ホットリスト、質問/回答/コメント、おすすめフィード、ユーザープロフィール、アイデア/質問/記事の投稿、自身のコンテンツの削除、いいね/フォロー、コレクション、通知などの操作を実行することに限定されます。ユーザーがQRコードログインを要求し、OpenClawが設定されている場合、QRコード画像をOpenClaw経由でユーザー指定のチャネルに送信できます。ユーザーに代わってCookieを第三者にアップロードしたり、知乎以外のドメインにアクセスしたり、上記のコマンド範囲を超える操作は含まれません。

Credentials

• 知乎ログイン状態：ユーザーのローカルマシンにのみ存在します（Linux/macOS：~/.zhihu-cli/cookies.json；Windows：%USERPROFILE%\.zhihu-cli\cookies.json、パーミッション 0600）。Agentは zhihu コマンドの実行を通じて間接的に使用するだけで、Cookieの内容をアップロード、転送、または会話/ログに書き込んではいけません。
• OpenClaw：openclaw message send を使用してQRコードを送信する場合、ユーザーはOpenClawおよびチャネルの認証情報を自身で設定する必要があります。本スキルは、この部分の認証情報を宣言したり、保持したりしません。

インストールと更新

• インストール（いずれかを選択）：
  • uv tool install pyzhihu-cli
  • pipx install pyzhihu-cli
  • pip install pyzhihu-cli
• 更新：インストール方法に応じて uv tool upgrade pyzhihu-cli、pipx upgrade pyzhihu-cli または pip install -U pyzhihu-cli を実行します。ユーザーが「zhihuをアップグレード/更新」と尋ねた場合、対応するコマンドを実行するように促します。インストール方法が不明な場合は、3つのコマンドすべてを提示しても構いません。
• バージョン：zhihu --version で現在のバージョンを確認します。

Agent ルール

1. 要求 → コマンド：以下の表に従ってマッピングします。
2. データクエリは --json を優先：データクエリ系のコマンド（例：search、hot、question、answers、answer、user、user-answers、user-articles、followers、following、feed、topic、collections、notifications、whoami など）を実行する際は、APIから完全なデータを取得し、解析、集計、またはユーザーへの表示を容易にするために、必ず --json を付けてください。端末のテーブルなどの非構造化出力のみに依存してはいけません。例外：feeds は現在 --json をサポートしていません。回答コメントを表示する必要がある場合は answer --comments を使用します（--json は回答の詳細のみを出力し、コメントは出力しません）。
3. ログインが必要な場合：まず zhihu status を実行します。未ログインの場合は zhihu login --qrcode を実行するか、ユーザーに zhihu login --cookie "..." を促します。
4. QRコードログイン：zhihu login --qrcode を実行した後、今回のセッションでまだQRコードを送信しておらず、かつユーザーがOpenClawを設定している場合 → まずQRコードをOpenClaw作業ディレクトリの media フォルダにコピーし、次に openclaw message send --channel <チャネル> --target <ターゲット> --media <media パス>/login_qrcode.png --message "知乎アプリでQRコードをスキャンしてログインを確認してください" を実行します。成功/失敗/タイムアウトするまでログインプロセスを中断しないでください。ユーザーが「再ログイン/アカウント変更」と言った場合は、現在のプロセスを中断してログインを再実行します。コピー手順：Linux/macOS：mkdir -p ~/.openclaw/workspace/media && cp ~/.zhihu-cli/login_qrcode.png ~/.openclaw/workspace/media/；Windows：mkdir "%USERPROFILE%\.openclaw\workspace\media" 2>nul & copy "%USERPROFILE%\.zhihu-cli\login_qrcode.png" "%USERPROFILE%\.openclaw\workspace\media\login_qrcode.png"（OpenClawの作業ディレクトリが異なる場合は実際のパスに置き換えてください）。
5. セキュリティ：Cookieはローカルにのみ保存されます。QRコードスキャンを優先し、信頼できない場所でのCookieの貼り付けを避けてください。zhihu logout でクリアできることを促しても構いません。
6. アップグレード：uv tool upgrade pyzhihu-cli / pipx upgrade pyzhihu-cli / pip install -U pyzhihu-cli。

要求 → コマンド 早見表

実行フロー

ユーザー要求
  → 「再ログイン/アカウント変更」の場合：現在のプロセスを中断 → zhihu login --qrcode → [QRコードを送信] → 完了を待つ
  → それ以外の場合：上記の表からコマンドを取得
    → そのコマンドがログインを必要とする場合：zhihu status → 未ログインの場合は zhihu login --qrcode または --cookie
      → QRコードスキャンでまだ画像を送信していない場合：mediaにコピー → openclaw message send --media ... → プロセスを維持
    → zhihu <サブコマンド> を実行（データクエリ系は必ず --json を付ける；feeds と answer --comments は例外）
    → 結果を整理またはエラーメッセージを提示

ログイン方法

よくある例

zhihu login --qrcode
zhihu status
zhihu search "Python" --json
zhihu hot --limit 10 --json
zhihu question 12345678 --json
zhihu answers 12345678 --limit 5 --json
zhihu answer 87654321 --comments --limit 5
zhihu user someone --json
zhihu feed --limit 5 --json
zhihu feeds --limit 3 --comment-limit 5
zhihu vote 87654321
zhihu pin "タイトル" -c "<p>本文</p>"
zhihu delete-pin 98765432 -y
zhihu notifications -l 10 --json
zhihu logout

本文はHTMLリッチテキストをサポートしています（ask の -d、pin の -c、article の本文）。

OpenClaw でQRコードを送信（QRコードスキャン時のみ）

1. QRコードが生成されていることを確認します（Linux/macOS：~/.zhihu-cli/login_qrcode.png；Windows：%USERPROFILE%\.zhihu-cli\login_qrcode.png）。
2. OpenClaw作業ディレクトリの media フォルダにコピーします：
   • Linux/macOS：mkdir -p ~/.openclaw/workspace/media && cp ~/.zhihu-cli/login_qrcode.png ~/.openclaw/workspace/media/
   • Windows（cmd）：mkdir "%USERPROFILE%\.openclaw\workspace\media" 2>nul & copy "%USERPROFILE%\.zhihu-cli\login_qrcode.png" "%USERPROFILE%\.openclaw\workspace\media\login_qrcode.png"
   • Windows（PowerShell）