research linkedin
orc research linkedin は、LinkedInの公開プロフィール・企業・投稿を取得し、人物や投稿を検索するコマンドです。企業IDやmember URNを使って関連する公開投稿を探し、activity形式の投稿URLから内容やコメントを確認できます。
認証済みのCLIと、アクセス可能なWorkspaceが必要です。--workspace で今回の対象を指定できます。
使い方
orc research linkedin profiles get --url https://www.linkedin.com/in/example/ --workspace <workspace-id> --json公開プロフィールを取得する。
サブコマンド
companies get
公開企業URLから企業情報を取得します。返された data.author.id は企業の人物・投稿一覧の入力に使えます。
orc research linkedin companies get [options]固有のオプション
--url
Public LinkedIn company URL.; max 2048 chars
型: string。必須。
orc research linkedin companies get --url <value>companies people list
数値の企業IDを指定して人物を一覧表示します。--include profile はプロフィールの追加取得を行い、返された行ごとに最大4 provider creditsが加算されます。
orc research linkedin companies people list [options]固有のオプション
--company-id
Numeric company ID from company data.author.id, not a slug or URL.
型: string。必須。
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。任意。
orc research linkedin companies people list --include <value>--page
One-based provider page. Do not combine with cursor.
型: number。任意。
orc research linkedin companies people list --page <value>companies posts list
数値の企業IDを指定して公開投稿を取得します。--sort-by で top または recent を指定できます。
orc research linkedin companies posts list [options]固有のオプション
--company-id
Numeric company ID from company data.author.id, not a slug or URL.
型: string。必須。
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。任意。
orc research linkedin companies posts list --sort-by <value>--page
One-based provider page. Do not combine with cursor.
型: number。任意。
orc research linkedin companies posts list --page <value>posts get
activityを識別する公開投稿URLから内容を取得します。shareやugcPostのIDを含むURLは使いません。
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。必須。
orc research linkedin posts get --url <value>posts comments list
activity形式の公開投稿URLからコメントを取得します。--post-type は取得元へのヒントであり、入力URLの制約は変わりません。
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。必須。
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。任意。
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。任意。
orc research linkedin posts comments list --sort-order <value>--page
One-based provider page. Do not combine with cursor.
型: number。任意。
orc research linkedin posts comments list --page <value>profiles get
公開プロフィールURLを指定してプロフィールを取得します。
orc research linkedin profiles get [options]固有のオプション
--url
Public LinkedIn profile URL.; max 2048 chars
型: string。必須。
orc research linkedin profiles get --url <value>profiles posts list
公開プロフィールURLの最近の投稿を取得します。最大100件、取得元の既定値は20件で、返された範囲より先へのページ送りはありません。
orc research linkedin profiles posts list [options]固有のオプション
--url
Public LinkedIn profile URL.; max 2048 chars
型: string。必須。
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。任意。
orc research linkedin profiles posts list --urn <value>people search
--query で人物を検索し、氏名、職種、勤務先、プロフィール言語で絞り込めます。企業の条件には名前ではなく数値IDを使います。
orc research linkedin people search [options]固有のオプション
--query
Search text.; max 500 chars
型: string。必須。
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。任意。
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。任意。
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。任意。
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。任意。
orc research linkedin people search --current-company <value>--past-company
Numeric previous-employer company ID. Omit to leave past company unrestricted.
型: string。任意。
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。任意。
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。任意。
orc research linkedin people search --include <value>--page
One-based provider page. Do not combine with cursor.
型: number。任意。
orc research linkedin people search --page <value>posts search
検索語、企業ID、またはmember URNで公開投稿を探します。relevance の並び順には検索語が必要で、企業・memberだけの検索には指定できません。
orc research linkedin posts search [options]固有のオプション
--query
Search text.; max 500 chars
型: string。任意。
orc research linkedin posts search --query <value>--from-company
Numeric company ID from company data.author.id, not a slug or URL.
型: string。任意。
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。任意。
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。任意。
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。任意。
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。任意。
orc research linkedin posts search --content-type <value>--page
One-based provider page. Do not combine with cursor.
型: number。任意。
orc research linkedin posts search --page <value>使用例
人物を職種で絞り込む。
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 では、次のグローバルオプションを使用できます。
各オプションの詳細と使用例は、グローバルオプションを参照してください。