CLI を使い始める

research reddit

Reddit の投稿、コメント、コミュニティを調査します。検索から得た正規の投稿 URL を詳細取得やコメント取得に渡せます。

使い方

terminal
orc research reddit posts search --query "AI agents" --sort new --workspace YOUR_WORKSPACE_ID --format json

新しい投稿を検索する

サブコマンド

posts get

投稿を取得します。

terminal
orc research reddit posts get [options]

固有のオプション

--url

Full HTTPS Reddit post permalink containing /r/{community}/comments/{post_id}. Shortlinks are not accepted.; max 2048 chars

型: string。必須。

terminal
orc research reddit posts get --url <value>

posts comments list

投稿のコメントを一覧取得します。

terminal
orc research reddit posts comments list [options]

固有のオプション

--url

Full HTTPS Reddit post permalink containing /r/{community}/comments/{post_id}. Shortlinks are not accepted.; max 2048 chars

型: string。必須。

terminal
orc research reddit posts comments list --url <value>

コメントを検索します。

terminal
orc research reddit comments search [options]

固有のオプション

--query

Search text. Search indexes do not guarantee exhaustive coverage.; max 500 chars

型: string。必須。

terminal
orc research reddit comments search --query <value>
--sort

Source comment search ordering.; enum: relevance|top|new

型: string。任意。

terminal
orc research reddit comments search --sort <value>

投稿を検索します。

terminal
orc research reddit posts search [options]

固有のオプション

--query

Search text. Search indexes do not guarantee exhaustive coverage.; max 500 chars

型: string。必須。

terminal
orc research reddit posts search --query <value>
--sort

Source ranking. timeframe does not apply to new.; enum: relevance|new|top|comment_count

型: string。任意。

terminal
orc research reddit posts search --sort <value>
--timeframe

Relative source time window. Ignored with sort=new; on subreddit listing applies only to top ordering.; enum: all|day|week|month|year

型: string。任意。

terminal
orc research reddit posts search --timeframe <value>

subreddits get

コミュニティを取得します。

terminal
orc research reddit subreddits get [options]

固有のオプション

--subreddit

Canonical subreddit name without r/, for example AskReddit. Preserve source casing.

型: string。必須。

terminal
orc research reddit subreddits get --subreddit <value>

subreddits posts list

コミュニティの投稿を一覧取得します。

terminal
orc research reddit subreddits posts list [options]

固有のオプション

--subreddit

Canonical subreddit name without r/, for example AskReddit. Preserve source casing.

型: string。必須。

terminal
orc research reddit subreddits posts list --subreddit <value>
--sort

Community listing order.; enum: best|hot|new|top|rising

型: string。任意。

terminal
orc research reddit subreddits posts list --sort <value>
--timeframe

Relative source time window. Ignored with sort=new; on subreddit listing applies only to top ordering.; enum: all|day|week|month|year

型: string。任意。

terminal
orc research reddit subreddits posts list --timeframe <value>

コミュニティの投稿を検索します。

terminal
orc research reddit subreddits posts search [options]

固有のオプション

--subreddit

Canonical subreddit name without r/, for example AskReddit. Preserve source casing.

型: string。必須。

terminal
orc research reddit subreddits posts search --subreddit <value>
--query

Search text. Search indexes do not guarantee exhaustive coverage.; max 500 chars

型: string。必須。

terminal
orc research reddit subreddits posts search --query <value>
--sort

Source search ordering.; enum: relevance|hot|top|new|comments

型: string。任意。

terminal
orc research reddit subreddits posts search --sort <value>
--timeframe

Relative window; ignored for new ordering.; enum: all|year|month|week|day|hour

型: string。任意。

terminal
orc research reddit subreddits posts search --timeframe <value>

出力と継続

1回で1ページを取得します。継続可能な場合はトップレベルの pagination.next_cursor を --cursor に渡し、検索条件を維持します。data.next_cursor は使用しません。has_more: null は不明であり、完了ではありません。--page-all は使えません。

JSONでは data.data に取得内容、data.pagination に継続情報、data.source に取得元情報が入ります。--raw はCLIの外枠を外し、--field data はAPIのデータだけを選択します。欠損・nullを0として扱わないでください。

data.usage.provider_credits は取得元の単位で、Orchestorの請求単位とは異なります。取得範囲・プロバイダー固有の制約は各APIリファレンスに記載しています。

必要な権限

orc auth login でベータ承認済みアカウントにログインするか、read スコープの API キーを使用します。アクセスできる Workspace を --workspace で指定します。research 専用の Workspace 許可リストは不要です。

グローバルオプション

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

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