​

research zenn

orc research zenn は、Zennの記事・本・スクラップを検索し、作者・トピック・Publicationから内容をたどるコマンドです。検索結果のownerとslugを使って詳細を取得し、検索件数やトップページの掲載も確認できます。

認証済みのCLIと、アクセス可能なWorkspaceが必要です。--workspace で今回の対象を指定できます。

トピックに関する記事を検索する。

記事を検索し、作者・トピック・Publicationと掲載順で絞り込めます。--publication-name は表示名ではなくPublicationのnameです。

Search text, 1–200 characters. Uses Zenn keyword search; content ordering is controlled by order.; max 200 chars

型: string。任意。

One-based page number. Prefer the returned pagination.next_url.

型: number。任意。

Zenn topic name, not its numeric ID. URL-encode the path segment.; max 200 chars

型: string。任意。

Filter by the Zenn author username.

型: string。任意。

Native Zenn order. Defaults to latest. daily is Trending; alltime is Alltime; recent is Recent. Scraps do not support recent.; enum: latest|daily|alltime|recent

型: string。任意。

Filter articles by publication name, not display name.

型: string。任意。

URLのownerとslugを指定して記事を取得します。数値IDではなく、一覧の api_url や元のURLにある値を使います。

本を検索し、作者・トピック・掲載順で絞り込みます。

Search text, 1–200 characters. Uses Zenn keyword search; content ordering is controlled by order.; max 200 chars

型: string。任意。

One-based page number. Prefer the returned pagination.next_url.

型: number。任意。

Zenn topic name, not its numeric ID. URL-encode the path segment.; max 200 chars

型: string。任意。

Filter by the Zenn author username.

型: string。任意。

Native Zenn order. Defaults to latest. daily is Trending; alltime is Alltime; recent is Recent. Scraps do not support recent.; enum: latest|daily|alltime|recent

型: string。任意。

URLのownerとslugを指定して本を取得します。数値IDではなく、一覧の api_url や元のURLにある値を使います。

Zennの取得機能とコンテンツの入口を確認します。

--q の検索語でPublicationを検索します。

Search text, 1–200 characters. Uses Zenn keyword search; content ordering is controlled by order.; max 200 chars

型: string。必須。

One-based page number. Prefer the returned pagination.next_url.

型: number。任意。

Publicationのnameを指定して公開情報を取得します。表示名や数値IDは使いません。

スクラップを検索し、作者やトピックで絞り込みます。掲載順は latest、daily、alltime に対応し、recent には対応しません。

Search text, 1–200 characters. Uses Zenn keyword search; content ordering is controlled by order.; max 200 chars

型: string。任意。

One-based page number. Prefer the returned pagination.next_url.

型: number。任意。

Zenn topic name, not its numeric ID. URL-encode the path segment.; max 200 chars

型: string。任意。

Filter by the Zenn author username.

型: string。任意。

Native scrap ordering: latest, daily or alltime. Defaults to latest. Keep the value unchanged when following pagination.; enum: latest|daily|alltime

型: string。任意。

URLのownerとslugを指定してスクラップを取得します。数値IDではなく、一覧の api_url や元のURLにある値を使います。

--q の検索語に対する原典の検索件数を取得します。件数は検索需要や記事品質を意味しません。

Search text, 1–200 characters. Uses Zenn keyword search; content ordering is controlled by order.; max 200 chars

型: string。必須。

トピックを一覧表示し、検索語やページ番号で探索します。

Search text, 1–200 characters. Uses Zenn keyword search; content ordering is controlled by order.; max 200 chars

型: string。任意。

One-based page number. Prefer the returned pagination.next_url.

型: number。任意。

トピック名を指定して公開情報を取得します。数値IDではなくnameを使います。

Zennトップページに掲載されるセクションを取得します。

--q の検索語でZennのユーザーを検索します。

Search text, 1–200 characters. Uses Zenn keyword search; content ordering is controlled by order.; max 200 chars

型: string。必須。

One-based page number. Prefer the returned pagination.next_url.

型: number。任意。

Zennのusernameを指定して公開情報を取得します。

記事のURLから詳細を取得する。

一覧は一回の呼び出しで一ページを取得します。返された pagination.next_url のクエリ値を、対応するフラグへ渡して続きを取得してください。検索条件は維持します。継続情報が不明でも全件取得済みとは判断せず、--page-all による自動巡回は行いません。

--json ではAPIレスポンス全体をCLIの data に保持します。取得内容は data.data、継続情報は data.pagination、取得元情報は data.source です。--raw はCLIの外枠を外し、--field data はAPIのデータだけを選択します。欠損値やnullを0として扱わないでください。

詳細取得のownerは元URLの最初のセグメント、slugはコンテンツのslugです。トピック名・username・Publicationのnameを使い、数値IDや表示名で代用しません。記事と本の --order は latest・daily・alltime・recent、スクラップは recent に非対応です。ページ送りでは掲載順を維持します。

APIキーではreadスコープが必要です。 プロバイダーのキーはサーバー側で管理します。

orc research zenn では、次のグローバルオプションを使用できます。

各オプションの詳細と使用例は、グローバルオプションを参照してください。