CLI を使い始める

research yc

Y Combinator の公開サイトから企業、創業者、ローンチ、ブログ投稿を取得します。公式パートナー API ではなく、公開ページを読むアダプターです。

使い方

terminal
orc research yc companies list --industry b2b --page 1 --workspace YOUR_WORKSPACE_ID --format json

B2B 企業の最初のページを取得する

サブコマンド

companies list

企業を一覧取得します。

terminal
orc research yc companies list [options]

固有のオプション

--industry

Source slug from a list response; not a URL.; max 200 chars

型: string。必須。

terminal
orc research yc companies list --industry <value>
--page

value

型: number。任意。

terminal
orc research yc companies list --page <value>

companies get

企業を取得します。

terminal
orc research yc companies get <slug> [options]

companies founders list

企業の創業者を一覧取得します。

terminal
orc research yc companies founders list <slug> [options]

launches list

ローンチを一覧取得します。

terminal
orc research yc launches list [options]

固有のオプション

--page

(use "null" or "reset" to clear)

型: number。任意。

terminal
orc research yc launches list --page <value>

launches get

ローンチを取得します。

terminal
orc research yc launches get <slug> [options]

posts list

投稿を一覧取得します。

terminal
orc research yc posts list [options]

固有のオプション

--page

value

型: number。任意。

terminal
orc research yc posts list --page <value>

posts get

投稿を取得します。

terminal
orc research yc posts get <slug> [options]

取得結果と使い方

既存の公開サイト取得アダプターを利用します。公式パートナーAPIではありません。readスコープとアクセス可能なWorkspaceが必要です。

JSON出力の data.data は取得したレコード、data.source は公開元URL・取得日時、data.pagination は継続情報です。詳細はオブジェクト、一覧は配列を返します。原典のフィールド名・追加フィールドを維持し、認証情報に該当するフィールドやURLクエリ値はマスクします。欠損は不明であり、0ではありません。HTMLは表示前にサニタイズしてください。

1回で1ページを取得します。pagination.next_url のクエリ値を次の呼び出しに渡してください。orc research yc companies list と orc research yc posts list の --page は1始まりです。orc research yc launches list の --page は0始まりです。reported_total は原典が報告する件数で、取得可能範囲や全件保証を意味しません。YCの創業者は指定企業の公開プロフィールに含まれる範囲です。ブログの別枠featuredは一覧に重複追加しません。

全件同期・保存・有料プロバイダー呼び出しは行いません。--page-all は使えません。--dry-run で送信内容を確認できます。--raw はCLIの外枠を省略します。終了コードは成功0、API・認証・通信失敗1、入力エラー2です。404は公開元に対象なし、429は公開元の制限、502は取得・構造変更、504はタイムアウトです。

必要な権限

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

グローバルオプション

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

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