leadgenius-cli

LeadGenius CLI スキル

コマンドラインから LeadGenius Pro B2B プラットフォームを操作します。このスキルでは、リード管理、エンリッチメント、AI スコアリング、パイプラインの自動化、ユーザーのプロビジョニングなどを行う lgp CLI を提供します。

セットアップ

CLI をグローバルにインストールします：

npm install -g leadgenius-cli

API キーを設定します（セッション間で保持されます）：

lgp config set api-key lgp_YOUR_KEY_HERE
lgp auth test

認証情報は ~/.leadgenius-cli/session.json に保存され、以降の実行時に自動的に読み込まれます。

主なワークフロー

リードを検索して一覧表示する

# Smart search — auto-detects email, name, or URL, case-insensitive
lgp leads search -q "Jane Doe"
lgp leads search -q "[email protected]"

# List leads for a client (shows interactive client picker if -c omitted)
lgp leads list
lgp leads list -c <client-id> --limit 20

CSV からリードをインポートする

lgp leads import --file leads.csv

CSV のヘッダーは API フィールドに直接対応します：firstName、lastName、email、companyName、title、linkedinUrl など。CLI からクライアントの選択を求められます。

エンリッチ、スコアリング、AI コンテンツの生成

lgp tasks enrich --lead <id>
lgp tasks score --lead <id>
lgp tasks copyright --lead <id>

FSD パイプラインを実行する（完全自動化）

lgp fsd run -c <client> --icp <id> --enrich --score
lgp fsd status <pipelineId>
lgp fsd campaigns

last.leadgenius.app への UI ログイン用に新しいユーザーをプロビジョニングする

# Creates Cognito user + CompanyUser + optional API key
lgp users provision -e [email protected] -p "SecurePass123!" --company-id <id> --role admin --group admin

# Set UI access (requires admin key)
lgp cognito set-attributes -e [email protected] --attributes '{"custom:allowed_views":"role:companyAdmin|*"}'

テリトリー企業を管理する

lgp companies list -c <client>
lgp companies leads <companyId>
lgp companies content-analysis <companyId>
lgp companies aggregate -c <client>
lgp companies events radar

EpsimoAI のクレジットとスレッド

TUI モード（引数なしで lgp を実行）では、Cognito トークン交換を通じて EpsimoAI が自動認証されます。CLI モードの場合：

lgp epsimo activate --cognito-token <jwt>
lgp epsimo info -t <token>
lgp epsimo credits -t <token>
lgp epsimo threads -t <token>

バグを報告して機能をリクエストする

lgp maintenance bugs report --desc "Description of the issue" --email [email protected]
lgp maintenance enhancements request --desc "Feature idea" --email [email protected]
lgp maintenance bugs list

すべてのコマンドグループ

グループ	説明	主なコマンド
auth	接続のテスト	auth test
leads	リードの CRUD、検索、インポート、重複排除	list、search -q、import --file、dedup
tasks	バックグラウンドジョブ	enrich、score、copyright
fsd	Full-Stack Demand パイプライン	run、campaigns、status
companies	テリトリーインテリジェンス	list、leads、aggregate、events
users	ユーザー管理	list、create、provision、menu-config
org	企業管理	list、create、rename、add-user
cognito	Cognito ユーザープール（管理者）	list、get、create、set-attributes
epsimo	EpsimoAI との統合	activate、info、credits、threads
tables	任意のテーブルに対する汎用 CRUD	list <Table>、create、update、delete
generate	リード生成	from-icp、direct、schedule
campaigns	ABM キャンペーン	list、create
clients	クライアント管理	list、create
shares	共有リンク	create、extend、revoke
webhooks	インバウンドイベント	list、get、reprocess
maintenance	バグと機能強化	bugs list/report、enhancements list/request
pipeline	分析	--start --end
account-analysis	アカウントインテリジェンス	list、analyze、export
admin	バックアップ、PITR、システム	backup、pitr、org-tree、views
config	セッション管理	show、set、get、reset

出力形式

デフォルトでは、CLI はテーブル、色、進捗バーを使った見やすい形式で出力します。生の JSON を出力するには --format json を使用します（jq やスクリプトへのパイプに便利です）：

lgp leads list -c <id> --format json | jq '.data[].email'

対話型 TUI

引数なしで起動すると、メニュー方式のインターフェースが表示されます：

lgp

TUI では、クライアント選択用のドロップダウン、EpsimoAI の自動認証、メニューから実行できるすべてのコマンドが利用できます。

API ベース URL

https://api.leadgenius.app/api/automation/

環境変数

変数	説明
LGP_API_KEY	API キー（lgp_ プレフィックス）
LGP_URL	ベース URL（デフォルト：https://api.leadgenius.app）
LGP_ADMIN_KEY	cognito/admin コマンド用の管理者キー

リファレンスドキュメント

• CLI README 全文
• API エンドポイント — リクエスト／レスポンスの例を含む、すべての REST エンドポイント
• CLI リファレンス — フラグの詳細なドキュメント
• ワークフロー — 手順ごとのビジネスワークフロー
• ユースケース — エンドツーエンドのシナリオ