pp-edgar

SEC EDGAR — Printing Press CLI

前提条件：CLI のインストール

このスキルは edgar-pp-cli バイナリを使用します。**このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。**インストールされていない場合は、まずインストールしてください。

1. Printing Press インストーラーを使ってインストールします。バイナリのインストール先は、macOS/Linux では $HOME/.local/bin、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin がデフォルトです。

   npx -y @mvanhorn/printing-press-library install edgar --cli-only
   

2. 確認します：edgar-pp-cli --version
3. 表示されたインストールディレクトリが、このスキルを実行するエージェント／ランタイムの $PATH に含まれていることを確認します。

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go による直接インストールに切り替えてください（Go 1.26.6 以降が必要です）。

go install github.com/mvanhorn/printing-press-library/library/other/edgar/cmd/edgar-pp-cli@latest

インストール後に --version が「command not found」を返す場合、ランタイムからバイナリのディレクトリを $PATH 経由で参照できません。確認に成功するまで、スキルのコマンドを実行しないでください。

この CLI を使用する場面

エージェントが、トークン効率よく利用できる形式の SEC 提出書類データ（一次情報ソースのバンドル、S/F を区別したインサイダー概要、四半期をまたぐ MD&A の差分、キャッシュされた提出書類を対象とするローカル FTS5 など）を必要とする場合に、edgar-pp-cli を使用します。複合的な primary-sources コマンドは LODESTAR 形式で、1 回の呼び出しで Gate 1/2/3 の投資仮説に必要な証拠一式を返します。連邦官報の検索、regulations.gov の案件、アクティビストの空売りレポート、NASDAQ の空売り残高には、この CLI を使用しないでください。これらは対象外であり、別の方法で扱います。

この CLI を使用しない場面

作成、更新、削除、公開、コメント、賛成票、招待、注文、メッセージ送信、予約、購入、またはリモート状態の変更が必要なリクエストには、この CLI を有効にしないでください。この印刷版 CLI が提供するのは、確認、エクスポート、同期、分析のための読み取り専用コマンドです。

独自の機能

この API の他のツールでは、以下の機能を利用できません。

蓄積されるローカル状態

• since — CIK ごとのローカルカーソルを使用して、指定したタイムスタンプ以降に提出された書類だけを返します。LODESTAR の /recheck ループ全体を 1 回の呼び出しで実行できます。

  四半期ごとの投資仮説の再確認では、提出書類の全インデックスを取得する前に、まずこれを使用してください。すでに確認した書類にかかるトークンコストを再度支払わずに済みます。

  edgar-pp-cli since AAPL --as-of 2026-05-08 --json
  

• fts — ローカルにキャッシュされた提出書類本文を FTS5 で全文検索します。ティッカーとフォームで絞り込み、正確な再読み込みに使えるスニペットの範囲とバイトオフセットを返します。

  同じ提出書類本文を何度も再検索する詳細分析では fts を使用してください。初回検索や複数の発行体にまたがる検索では、統合済みの efts コマンドを使用してください。

  edgar-pp-cli fts "going concern" --ticker AAPL --form 10-Q --json
  

サービス固有のコンテンツパターン

• eightk-items — 解析済みの Item 番号を使って 8-K を列挙します。--material-only フラグを指定すると、添付書類のみの再提出（Item 9.01 のみ）を除外します。

  「重要なことが何か起きたか」を知りたい場合は、8-K の本文を取得する代わりにこれを使用してください。提出書類のテキストを読まずに、1 回の呼び出しで答えが得られます。

  edgar-pp-cli eightk-items AAPL --since 2026-05-08 --material-only --json
  

• ownership-crosses — 発行体について提出された 13D および 13G 書類を列挙し、提出者名、保有割合、提出日時を返します（他の誰かがそのティッカーの 5% を超えて保有した場合）。

  LODEST​AR Gate 3 の非対称構造の確認で、提出書類一覧をスクロールせずにアクティビストや機関投資家の集中を見つけるために使用してください。

  edgar-pp-cli ownership-crosses AAPL --json
  

• governance-flags — サービス固有の 3 つの独立したシグナルを 1 回の呼び出しにまとめます。8-K Item 4.01 の監査人変更、Item 4.02 の信頼性に関する訂正、NT-10-K の提出遅延通知（Form 12b-25）です。

  早期の失格判定に使用してください。いずれかのフラグが検出された場合は、投資仮説全体の分析にトークンを費やす前に LODESTAR に報告してください。

  edgar-pp-cli governance-flags AAPL --since 2y --json
  

エンティティ横断結合

• insider-followthrough — 上級役員によるコードSの100万ドル以上の売却ごとに、その後90日間の8-Kをスキャンして重要項目を探し、（売却、後続の重要な8-K、経過日数）のペアを出力します。

  インサイダーによる売却の後に重要な開示が続く場合は、LODESTAr Gate 2の実行検証で使用します。不都合なニュースの前に経営陣が退任する動きを明らかにします。

  edgar-pp-cli insider-followthrough AAPL --json
  

  Form 4の取り込み上限。 insider-summary、insider-followthrough、primary-sourcesは、共有の--max-form4 N上限（デフォルトは200）を通じてForm 4の提出書類を取り込みます。これにより、提出数の多い発行体に対するDB/APIの負荷を制限します。この上限によって古い提出書類が除外された場合、出力にはform4_skippedの下にform4_truncated: trueとform4_total_in_window: <N>が表示され、stderrにWARNが出ます。通知なしに除外されることはありません。無効にするには--max-form4 0、対象範囲を広げるにはより大きな値を指定します。

• xbrl-pivot — コンセプトの別名（Revenues ↔ RevenueFromContractWithCustomerExcludingAssessedTax ↔ SalesRevenueNet）を解決し、ティッカー×四半期×コンセプトのフラットなテーブルを作成する、複数ティッカー対応のXBRLピボットです。

  横断的な品質スクリーニングに使用します。50社分のcompanyfacts JSONを手作業で解析する前に、ピボットしてください。

  edgar-pp-cli xbrl-pivot --tickers AAPL,MSFT,GOOGL --concepts Revenues,NetIncomeLoss --quarters 8 --csv
  

トークン効率のよい抽出

• sections — 10-Kまたは10-Qから指定した項目をバイトオフセット境界で抽出し、100KB～10MBのHTML本文全体ではなく、要求された項目のみをコンパクトなJSONで出力します。

  10-Kの本文をそのまま取得する代わりに使用してください。リスク要因とMD&Aだけが必要な場合、トークンを桁違いに節約できます。

  edgar-pp-cli sections AAPL --form 10-K --items 1A,7,7A --json
  

コマンドリファレンス

companies — 企業識別子（ティッカー → CIK）と発行体ごとの提出書類インデックス

• edgar-pp-cli companies lookup — SECの夜間インデックスからティッカー → CIK（および企業名、SIC）を解決します。ローカルSQLiteに24時間キャッシュします。
• edgar-pp-cli companies submissions — 企業の構造化された提出書類インデックス（アクセッション番号、フォーム種別、提出日時を含む提出履歴）を返します。

companyfacts — CIKのXBRL企業ファクト（売上高、純利益、資産、キャッシュフローなどの財務コンセプト）

• edgar-pp-cli companyfacts <cik> — CIKに関するすべてのXBRL企業ファクトを返します。必要に応じて、クライアント側で単一のコンセプトに絞り込めます。

efts — EDGARのすべての提出書類を対象とした全文検索（efts.sec.gov）。キャッシュ済みの提出書類本文を対象にオフラインでFTS5検索する場合は、代わりにオフラインのftsコマンドを使用します。

• edgar-pp-cli efts <q> — EDGARの提出書類を対象にオンライン全文検索します。キャッシュ済みの本文を対象にオフラインでFTS5検索する場合は、edgar-pp-cli ftsを使用します。

filings — フォーム種別ごとの提出書類取得と個別の提出書類ドキュメント取得

• edgar-pp-cli filings browse — CIKとフォーム種別を指定して、EDGARの提出書類インデックスを取得します。HTML/Atomを返します。ジェネレーターがラップしますが、解析は…
• edgar-pp-cli filings get — 特定のアクセッションに対応する提出書類インデックスページまたはドキュメントを生の形式で取得します。アクセッションはハイフンなしの形式で指定する必要があります（例：…）。

適切なコマンドを見つける

やりたいことはわかっているものの、どのコマンドを使えばよいかわからない場合は、CLIに直接尋ねてください。

edgar-pp-cli which "<capability in your own words>"

whichは、自然言語で指定した機能クエリを、このCLIの厳選された機能インデックスから最適なコマンドに対応付けます。終了コード0は少なくとも1つの候補が見つかったことを示し、終了コード2は確信度の高い候補が見つからなかったことを示します。その場合は--helpを確認するか、より絞り込んだクエリを使用してください。

レシピ

LODESTARの完全な調査データ取得

edgar-pp-cli primary-sources AAPL --json --select shares_outstanding,senior_insider_sales,recent_eightk_items,def14a_governance

エージェント向けのコンパクトなJSONです。primary-sourcesは完全なデータ一式を返し、--selectを使うとLODESTAR Gateの評価で実際に必要なフィールドだけに絞り込み、定型情報を除外できます。

四半期ごとの再確認差分

edgar-pp-cli since AAPL --as-of 2026-05-08 --json

指定したタイムスタンプより後に提出された提出書類のみを対象にします。ローカルカーソルを使うため、キャッシュが温まっていればSECへの再アクセスはありません。差分に8-Kが含まれる場合は、eightk-items --material-onlyと組み合わせてください。

インサイダーの後続動向パターン

edgar-pp-cli insider-followthrough AAPL --json

エンティティ横断結合：上級役員による100万ドル以上のコードS売却と、その後90日以内に提出された重要な8-K項目を組み合わせます。不都合なニュースの前に経営陣が退任する動きを明らかにします。

XBRL 横断スクリーニング

edgar-pp-cli xbrl-pivot --tickers AAPL,MSFT,GOOGL,META --concepts Revenues,NetIncomeLoss --quarters 8 --csv

コンセプトの別名を解決しながら、複数の銘柄をピボット表示します。後続のスクリーニングやスプレッドシートへの読み込みに使えるフラットなテーブルです。表形式のパイプ処理には --csv を使います。

トークン効率の高い10-K項目の抽出

edgar-pp-cli sections AAPL --form 10-K --items 1A,7,7A --json --select item,text_offset,text

リスク要因（1A）、MD&A（7）、定量的開示（7A）のみをバイトオフセットとともに取得します。提出書類本文全体と比べて、トークン数を桁違いに削減できます。

ローカルでのFTS5詳細検索

edgar-pp-cli fts "going concern" --ticker AAPL --form 10-Q --json

キャッシュされた提出書類の本文をローカルのFTS5でオフライン検索し、正確な再読み込みに使えるスニペットとバイトオフセットを出力します。キャッシュが空の場合は、先に同期を実行してください。

認証の設定

APIキーは不要です。SEC EDGARは公開されています。ユーザーエージェントが識別情報になります。COMPANY_PP_CONTACT_EMAIL を一度設定すれば、すべてのリクエストが lodestar-edgar-pp-cli <email> として送信されます。環境変数が設定されていない場合、CLIはセットアップ方法を示す明確なエラーを表示して実行を拒否します。レート制限は、持続的に毎秒2リクエスト以下（SECの上限である毎秒10リクエストを大きく下回る水準）で、429応答時には適応型バックオフを行います。

edgar-pp-cli doctor を実行して設定を確認してください。

エージェントモード

任意のコマンドに --agent を追加します。次のオプションに展開されます：--json --compact --no-input --no-color --yes。

• パイプ処理可能 — stdoutにJSON、stderrにエラーを出力します

• フィルタリング可能 — --select でフィールドを絞り込めます。ドット区切りのパスはネストされた構造をたどり、配列では各要素をたどります。冗長なAPIでコンテキストを小さく保つために重要です：

  edgar-pp-cli companyfacts mock-value --agent --select id,name,status
  

• プレビュー可能 — --dry-run でリクエストを送信せずに表示します

• オフラインでも利用可能 — sync/searchコマンドは、利用可能な場合、ローカルのSQLiteストアを使用できます

• 非対話型 — プロンプトを表示せず、すべての入力をフラグで指定します

• 読み取り専用 — 作成、更新、削除、公開、コメント、賛成票の投票、招待、注文、送信など、データを変更するリクエストにはこのCLIを使用しないでください

レスポンスエンベロープ

ローカルストアまたはAPIからデータを読み取るコマンドは、出力をプロベナンスエンベロープでラップします：

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データには .results を解析し、ライブデータかローカルデータかを確認するには .meta.source を参照してください。人間が読める N results (live) という概要は、stdoutがターミナルの場合にのみstderrに出力されます。パイプ処理やエージェントで利用する場合、stdoutにはJSONのみが出力されます。

エージェントからのフィードバック

このCLIに問題があると気づいた場合（エージェントが気づいた場合も含む）、記録してください：

edgar-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
edgar-pp-cli feedback --stdin < notes.txt
edgar-pp-cli feedback list --json --limit 10

エントリーはローカルの ~/.edgar-pp-cli/feedback.jsonl に保存されます。EDGAR_FEEDBACK_ENDPOINT が設定されていて、かつ --send が渡されているか EDGAR_FEEDBACK_AUTO_SEND=true に設定されていない限り、POSTされることはありません。デフォルトの動作ではローカルにのみ保存されます。

バグ報告ではなく、意外に感じたことを書いてください。短く、具体的に、1行で。それが積み重なっていく要素です。

出力先

すべてのコマンドで --deliver <sink> を指定できます。出力は標準出力への出力に加えて、または標準出力の代わりに、指定した出力先へ送られます。エージェントは手動でパイプ処理することなく、コマンド結果を振り分けられます。次の3つの出力先に対応しています：

出力先	動作
stdout	デフォルト。標準出力のみに書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（一時ファイル＋リネーム）
webhook:<url>	出力本文をURLにPOSTします（--compact の場合は application/json または application/x-ndjson）

未知のスキームを指定すると、対応している出力先を示す構造化エラーを返して拒否されます。Webhookへの送信に失敗すると、ゼロ以外の終了コードを返し、URLとHTTPステータスをstderrに記録します。

名前付きプロファイル

プロファイルは保存済みのフラグ値のセットで、呼び出しごとに再利用できます。スケジュールされたエージェントが、毎回同じ設定で同じコマンドを呼び出す場合に使用します。これはHeyGenの「Beacon」パターンです。

edgar-pp-cli profile save briefing --json
edgar-pp-cli --profile briefing companyfacts mock-value
edgar-pp-cli profile list --json
edgar-pp-cli profile show briefing
edgar-pp-cli profile delete briefing --yes

明示的に指定したフラグは常にプロファイルの値より優先され、プロファイルの値はデフォルトより優先されます。agent-context は、実行時にプロファイルを検出できるよう、利用可能なすべてのプロファイルを available_profiles に一覧表示します。

終了コード

コード	意味
0	成功
2	使用方法のエラー（引数が不正）
3	リソースが見つかりません
4	認証が必要です
5	APIエラー（上流の問題）
7	レート制限中（待機して再試行）
10	設定エラー

引数の解析

$ARGUMENTS を解析します：

1. 空、help、または --help → edgar-pp-cli --help の出力を表示します
2. install で始まる → mcp で終わる場合 → MCP をインストールします。それ以外の場合 → 上記の前提条件を参照してください
3. その他すべて → 直接使用します（--agent を指定して CLI コマンドとして実行します）

MCP サーバーのインストール

この CLI の公開ライブラリエントリーまたはビルド済みリリースから MCP バイナリをインストールし、登録します：

claude mcp add edgar-pp-mcp -- edgar-pp-mcp

確認：claude mcp list

直接使用

1. インストール済みか確認します：which edgar-pp-cli 見つからない場合は、インストールを提案します（このスキルの冒頭にある前提条件を参照してください）。
2. ユーザーのクエリに最適なコマンドを、上記の独自の機能とコマンドリファレンスから選びます。
3. --agent フラグを指定して実行します：

   edgar-pp-cli <command> [subcommand] [args] --agent
   

4. 曖昧な場合は、サブコマンドのヘルプを確認します：edgar-pp-cli <command> --help。