mcpField
T
trader-pelosi

trader-pelosi

github.com/jakeschincariolデータ・データベース85147 回インストール2 週間前に更新
リポジトリ

trader-pelosi について

trader-pelosiは、米国下院議員の公開資産取引報告を追跡するPythonスキルです。下院書記官の索引から新しい報告を確認して取引内容を読み取り、開示までの遅れや金額の範囲を示します。投資シグナルとして扱わない点も明記します。

主な機能

  1. 01下院の開示索引の確認
  2. 02新しいPTRの検出と記録
  3. 03報告書から取引内容を読み取り
  4. 04所有者・金額範囲・開示遅延の表示
  5. 05保有銘柄に関係する取引の通知

活用シーン

  1. 01新たに提出された下院報告の確認
  2. 02開示取引と提出までの日数の確認
  3. 03保有銘柄に関する開示取引の特定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jakeschincariol/trader-skill --skill trader-pelosi

インストール後、Claude Code で/trader-pelosiを入力して読み込まれたか確認します。

同梱ファイルptr.py

詳細

trader-pelosi

議会議員は、自身の取引、配偶者の取引、扶養する子どもの取引を報告する必要があります。下院書記官は各報告書を PDF として公開し、年ごとにすべてを一覧にしたインデックスファイルを用意します。このスキルはそのインデックスを読み取り、新しい報告書が掲載された瞬間を検知して、報告書を読み取ります。

高速ですが、早くはありません。PTR は議員が取引を知ってから30日以内、かつ取引から45日を超えない期間内に提出する必要があるため、誰かが読める時点では、その取引から数日から数週間が経過しています。ここにインサイダー情報はありません。公開された提出書類をすばやく読むだけです。そのことを毎回明記してください。

このフォルダー内のツール（Python 標準ライブラリを使用。PDF をローカルで読む場合は pdftotext（poppler）の使用も任意です）：

python3 "${CLAUDE_SKILL_DIR}/ptr.py" --help

読み取りと書き込みの内容

  • https://disclosures-clerk.house.gov/public_disc/financial-pdfs/<YEAR>FD.zip を読み取ります（提出書類ごとに1つの <Member>：氏名、選挙区、FilingType、FilingDate、DocID）。 また、各 PTR を .../public_disc/ptr-pdfs/<YEAR>/<DocID>.pdf から読み取ります。
  • trader/state/pelosi.json に書き込みます（すでに表示した DocID を記録し、各 PTR のアラートが一度だけ表示されるようにします）。ダウンロードした PDF は trader/state/ptr-pdfs/ に保存します。
  • trader/portfolio.json が存在する場合は読み取り、保有資産の取引に印を付けます。

ルール

  • トラッカーではなく、提出書類を引用してください。 各行は、書記官のサイトにある PTR PDF に基づき、DocID とリンクを記載します。サードパーティのトラッカーは閲覧には便利ですが、誤っていることがあります（Capitol Trades では、Pelosi の取引日が PTR より1日早く表示されていました）。PTR の情報を優先してください。
  • 金額は範囲で示します。 「$1,000,001 - $5,000,000」とし、「$3 million」とはしません。
  • 所有者は重要です。 SP は配偶者、JT は共同、DC は扶養する子ども、空欄は議員本人を表します。Pelosi の2026年の取引はすべて SP、つまり Paul Pelosi によるものです。
  • 遅延を明記してください。 各行に、取引から提出までに経過した日数を表示します。45日を超える場合は遅延として印を付けます。
  • オプションはオプションです。 権利行使価格と満期日が記載されたコールの購入は、株式の購入ではありません。このツールは説明文から契約数、権利行使価格、満期日を読み取り、権利行使に印を付けます。

ステップ1：提出済みの書類を確認する

python3 "${CLAUDE_SKILL_DIR}/ptr.py" index --member pelosi
python3 "${CLAUDE_SKILL_DIR}/ptr.py" index --since 2026-10-01        # every member
python3 "${CLAUDE_SKILL_DIR}/ptr.py" index --member "Josh Gottheimer" --year 2025

--member は姓、「名 姓」または「姓, 名」を指定し、複数回指定できます。 --type '' はすべての提出書類の種類を一覧表示します（年次報告書の種類は O です）。

ステップ2：新しい書類を監視する

python3 "${CLAUDE_SKILL_DIR}/ptr.py" new --member pelosi --read

前回の確認時に未確認だった PTR のみを表示します（初回実行時は直近45日分を表示します）。--read を指定するとダウンロードして読み取り、状態ファイルに記録します。終了コード 1 は新しい書類がないことを意味します。1月には前年のインデックスも確認します。書記官はインデックスファイルを1日1回ほど再構築します（2026-10-13 に読み取ったコピーには、その日の09:00のタイムスタンプがありました）。そのため、平日に1時間ごとに確認すれば十分です。/loop 1h またはスケジュールタスクで実行してください。

ステップ3：報告書を読む

python3 "${CLAUDE_SKILL_DIR}/ptr.py" fetch 20035143
python3 "${CLAUDE_SKILL_DIR}/ptr.py" parse ptr.txt --filed 2026-08-21 --json

fetch は PDF を保存し、pdftotext がインストールされていれば行を表示します。インストールされていない場合は、保存した PDF を開いて直接読んでください。PDF は読めます。 parse は pdftotext -layout のテキストを行に変換します。報告書が複数ページにわたる場合は、行数を PDF と照合してください。

例：リールのアラート

NEW Periodic Transaction Report: Hon. Nancy Pelosi (CA11) filed 2026-08-21, doc 20035143
  - spouse purchase, Bloom Energy Corporation Class A Common Stock (BE): 100 call
    options, $100 strike, expires 2027-06-17, $1,000,001 - $5,000,000, traded
    2026-07-24, disclosed 28 days later

同じ PTR には、BE 株10,000株と5,000株、07/28 の BE コール100件の追加分、Intel 株と Intel コール50件（権利行使価格 $50、6/17/27）、さらにティッカーのない非公開の不動産 LLC も記載されています。彼女のその他の2026年の PTR は、20033725（01/23）、20034836（06/23、Intel と Uber のコール）、20035553（10/02、不動産 LLC）です。そして、こう述べます。「これは、取引から28日後に提出された公開情報です。7月に Paul Pelosi が何を購入したかを示すものであり、次に誰が何を買うかを示すものではありません。」

ユーザーがこれに基づいて行動したい場合は、通常の手順を踏みます。株式のみ（設定では allow_options: false）、/trader-budget で金額を決め、/trader-risk で確認し、本人の承認後にのみ /trader-broker が発注します。

上院：手動で行う方法

上院の報告書は https://efdsearch.senate.gov で公開されています。検索する前に、報告書の利用に関する法的制限に同意するチェックボックスをオンにするよう求められます。これは本人が同意するものなので、このスキルではクリックも自動化もしません。手順は次のとおりです。

  1. ユーザーはブラウザーで https://efdsearch.senate.gov/search/ を開き、自分で同意します。
  2. 報告書の種類として「Periodic Transactions」を選び、上院議員の姓を入力し、日付範囲を設定して検索します。
  3. 報告書を開きます。電子提出された報告書には取引の表が表示され、紙で提出された報告書はスキャン画像です。
  4. 表（またはスクリーンショット、保存したページ）をチャットに貼り付けます。報告書へのリンクを付け、下院の行と同じ形式で、同じ45日間の注意書きも添えてまとめます。

絶対にしないこと

  • 議員が内部情報を持っている、または政治家の取引をまねれば市場に勝てると述べたり、ほのめかしたりしません。リターンに関する主張もしません。
  • 範囲で示された金額を正確な金額として示したり、トラッカーの日付を取引日として示したりしません。
  • 注文を出したり、オプション取引をまねたりしません。
  • 上院の同意手続きやログインを自動化しません。

安全性

  • 金融アドバイスではなく、教育とツールの提供を目的としています。このパックに売買の推奨は一切含まれていません。
  • デフォルトではペーパートレード（trader/config.json の "paper": true）。
  • 注文を出すのは /trader-broker のみです。その場合も、/trader-risk のチェックに合格し、ユーザーがその注文についてチャットで明示的に「はい」と入力し、さらに Claude で証券会社ツールが「承認が必要」に設定されていて（Customize > Connectors > tool permissions）、Claude 独自の「一度だけ許可／拒否」カードも表示される必要があります。注文ツールで「常に許可」は絶対に選択しないでください。
  • 設定で許可され、ユーザーが確認しない限り、オプション取引、証拠金取引、空売り、レバレッジは行いません。
  • 議会議員の取引は、取引から最大45日後に提出される公開情報です（STOCK Act）。このスキルは情報をすばやく読み取りますが、内部情報は持っておらず、そのことを明示します。

コメント

Markdown 対応