CLI を使い始める

research linkedin

orc research linkedin は、LinkedInの公開プロフィール・企業・投稿を取得し、人物や投稿を検索するコマンドです。企業IDやmember URNを使って関連する公開投稿を探し、activity形式の投稿URLから内容やコメントを確認できます。

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

使い方

terminal
orc research linkedin profiles get --url https://www.linkedin.com/in/example/ --workspace <workspace-id> --json

公開プロフィールを取得する。

サブコマンド

companies get

公開企業URLから企業情報を取得します。返された data.author.id は企業の人物・投稿一覧の入力に使えます。

terminal
orc research linkedin companies get [options]

固有のオプション

--url

Public LinkedIn company URL.; max 2048 chars

型: string。必須。

terminal
orc research linkedin companies get --url <value>

companies people list

数値の企業IDを指定して人物を一覧表示します。--include profile はプロフィールの追加取得を行い、返された行ごとに最大4 provider creditsが加算されます。

terminal
orc research linkedin companies people list [options]

固有のオプション

--company-id

Numeric company ID from company data.author.id, not a slug or URL.

型: string。必須。

terminal
orc research linkedin companies people list --company-id <value>
--include

Join fresh profile details. Adds up to 4 provider credits per returned row.; enum: profile

型: string。任意。

terminal
orc research linkedin companies people list --include <value>
--page

One-based provider page. Do not combine with cursor.

型: number。任意。

terminal
orc research linkedin companies people list --page <value>

companies posts list

数値の企業IDを指定して公開投稿を取得します。--sort-by で top または recent を指定できます。

terminal
orc research linkedin companies posts list [options]

固有のオプション

--company-id

Numeric company ID from company data.author.id, not a slug or URL.

型: string。必須。

terminal
orc research linkedin companies posts list --company-id <value>
--sort-by

Provider ordering for company posts: top or recent. Omission sends no ordering override.; enum: top|recent

型: string。任意。

terminal
orc research linkedin companies posts list --sort-by <value>
--page

One-based provider page. Do not combine with cursor.

型: number。任意。

terminal
orc research linkedin companies posts list --page <value>

posts get

activityを識別する公開投稿URLから内容を取得します。shareやugcPostのIDを含むURLは使いません。

terminal
orc research linkedin posts get [options]

固有のオプション

--url

Public LinkedIn post URL. Post URLs must identify an activity, not share/ugcPost IDs.; max 2048 chars

型: string。必須。

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

posts comments list

activity形式の公開投稿URLからコメントを取得します。--post-type は取得元へのヒントであり、入力URLの制約は変わりません。

terminal
orc research linkedin posts comments list [options]

固有のオプション

--url

Public LinkedIn post URL. Post URLs must identify an activity, not share/ugcPost IDs.; max 2048 chars

型: string。必須。

terminal
orc research linkedin posts comments list --url <value>
--post-type

Provider post-type hint for comment retrieval. The url must still be an accepted activity URL. Omission sends no type override.; enum: activity|ugc

型: string。任意。

terminal
orc research linkedin posts comments list --post-type <value>
--sort-order

Provider comment ordering: recency or relevance. Omission sends no ordering override.; enum: recent|relevance

型: string。任意。

terminal
orc research linkedin posts comments list --sort-order <value>
--page

One-based provider page. Do not combine with cursor.

型: number。任意。

terminal
orc research linkedin posts comments list --page <value>

profiles get

公開プロフィールURLを指定してプロフィールを取得します。

terminal
orc research linkedin profiles get [options]

固有のオプション

--url

Public LinkedIn profile URL.; max 2048 chars

型: string。必須。

terminal
orc research linkedin profiles get --url <value>

profiles posts list

公開プロフィールURLの最近の投稿を取得します。最大100件、取得元の既定値は20件で、返された範囲より先へのページ送りはありません。

terminal
orc research linkedin profiles posts list [options]

固有のオプション

--url

Public LinkedIn profile URL.; max 2048 chars

型: string。必須。

terminal
orc research linkedin profiles posts list --url <value>
--urn

Bare member URN from profile data.author.ext.urn; not a profile URL or prefixed URN.

型: string。任意。

terminal
orc research linkedin profiles posts list --urn <value>

--query で人物を検索し、氏名、職種、勤務先、プロフィール言語で絞り込めます。企業の条件には名前ではなく数値IDを使います。

terminal
orc research linkedin people search [options]

固有のオプション

--query

Search text.; max 500 chars

型: string。必須。

terminal
orc research linkedin people search --query <value>
--first-name

Additional first-name search filter. Omit to leave unspecified; query remains required.; max 500 chars

型: string。任意。

terminal
orc research linkedin people search --first-name <value>
--last-name

Additional last-name search filter. Omit to leave unspecified; query remains required.; max 500 chars

型: string。任意。

terminal
orc research linkedin people search --last-name <value>
--title

Job-title search filter forwarded to the provider. Omit to leave unspecified.; max 500 chars

型: string。任意。

terminal
orc research linkedin people search --title <value>
--current-company

Comma-separated numeric company IDs, for example 1001,1002. Names and URLs are not accepted. Omit to leave current company unrestricted.; max 500 chars

型: string。任意。

terminal
orc research linkedin people search --current-company <value>
--past-company

Numeric previous-employer company ID. Omit to leave past company unrestricted.

型: string。任意。

terminal
orc research linkedin people search --past-company <value>
--profile-language

Two-lowercase-letter profile-language filter, for example en or ja. Omission sends no language filter.

型: string。任意。

terminal
orc research linkedin people search --profile-language <value>
--include

Join fresh profile details. Adds up to 4 provider credits per returned row.; enum: profile

型: string。任意。

terminal
orc research linkedin people search --include <value>
--page

One-based provider page. Do not combine with cursor.

型: number。任意。

terminal
orc research linkedin people search --page <value>

検索語、企業ID、またはmember URNで公開投稿を探します。relevance の並び順には検索語が必要で、企業・memberだけの検索には指定できません。

terminal
orc research linkedin posts search [options]

固有のオプション

--query

Search text.; max 500 chars

型: string。任意。

terminal
orc research linkedin posts search --query <value>
--from-company

Numeric company ID from company data.author.id, not a slug or URL.

型: string。任意。

terminal
orc research linkedin posts search --from-company <value>
--from-member

Bare member URN from profile data.author.ext.urn; not a profile URL or prefixed URN.

型: string。任意。

terminal
orc research linkedin posts search --from-member <value>
--sort-by

Provider ordering. relevance requires query; member/company-only searches cannot request relevance. Omission sends no sort override.; enum: date_posted|relevance

型: string。任意。

terminal
orc research linkedin posts search --sort-by <value>
--date-posted

Provider publication recency window. Omission sends no recency filter.; enum: past_24h|past_week|past_month

型: string。任意。

terminal
orc research linkedin posts search --date-posted <value>
--content-type

Restrict search to a provider content category. Omission sends no content-type filter.; enum: videos|photos|jobs|live_videos|documents|collaborative_articles

型: string。任意。

terminal
orc research linkedin posts search --content-type <value>
--page

One-based provider page. Do not combine with cursor.

型: number。任意。

terminal
orc research linkedin posts search --page <value>

使用例

人物を職種で絞り込む。

terminal
orc research linkedin people search --query "engineer" --title "software engineer" --workspace <workspace-id> --json

人物を職種で絞り込む。

出力と継続

継続できる一覧ではAPIのトップレベル pagination.next_cursor を --cursor に渡し、条件を維持します。CLIのJSON出力からは data.pagination.next_cursor を取り出してください。取得内容の内部にある data.next_cursor は継続に使いません。has_more: null は不明を意味し、完了ではありません。--page-all は使えません。

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

data.usage.provider_credits は取得元の単位で、Orchestorの請求単位とは異なります。

--page と --cursor は同時に指定できません。人物一覧や人物検索の --limit は原典の一ページから先頭1〜10件を返し、除外した行を次へ繰り越しません。

必要な権限

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

グローバルオプション

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

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

関連項目