finance-markets-research

金融・市場調査

Crawlora API から、株式、暗号資産、SEC 提出書類、プライベート市場のデータを正規化された JSON として取得します。金融サイトをスクレイピングしたり、10-K を手作業で解析したりする必要はありません。

このスキルを使う場面

• 「 の株価／財務情報／ニュースは？」または「その履歴をチャートにして。」
• 「 の最近の SEC 提出書類／インサイダー取引／機関投資家の保有状況は？」
• 「 は最近どんな取引をした？」
• 「 の時価総額／価格は？／今話題になっている？」
• 「<VC firm / private company / fund / LP> のプロフィールを教えて。」
• 株式スクリーニング、決算カレンダー、セクター／業界の概要。
• ティッカーに関するサンプリングされた Reddit の議論を同じ期間の株価情報と併せて確認する場合は、インストールされていれば reddit-stock-sentiment-research を使います。
• 複数の上場企業を対象に、期間を揃えた財務諸表マトリックスを作成する場合は、company-fundamentals-comparison を使います。

セットアップ（初回のみ）

• https://crawlora.net で無料の Crawlora API キーを取得します（月 2,000 クレジット、カード不要）。
• ヘルパーを実行する前に、環境変数に CRAWLORA_API_KEY を設定します。
• ヘルパーは環境変数から CRAWLORA_API_KEY を読み込み、https://api.crawlora.net/api/v1 にリクエストを送信します。キーがないか無効な場合は → 401。

仕組み

データの領域を選び、次に処理を選びます。

1. 株式（Yahoo Finance） — 1 つの銘柄には /yahoo-finance/ticker/{symbol}/quote|info|history|financials|analysts|news|options|holders|dividends|splits を使用します。スクリーニングには /yahoo-finance/screener/{id} または POST /yahoo-finance/screener、名前から銘柄を特定するには /yahoo-finance/search、話題の銘柄を調べるには /yahoo-finance/trending/{region} を使用します。
2. SEC 提出書類 — ティッカーから CIK を特定するには /sec/company/search を使い、続けて /sec/company/submissions、/sec/filing、/sec/filing/sections（10-K/10-Q の項目抽出）、/sec/financials（正規化された財務諸表）、/sec/insider （Form 3/4/5）、/sec/institutional-holdings（13F-HR）を使用します。/sec/full-text-search は EDGAR の全提出書類を検索し、/sec/frames は対象期間のすべての提出者について、1 つの XBRL 概念を比較します。
3. 米国議会 — 公開された議会の取引開示を検索するには /congress/stock-disclosures、提出されたレポート 1 件の解析済み詳細を確認するには /congress/report を使用します。
4. 暗号資産（CoinGecko） — コインのプロフィールには /coingecko/coin/{id}、市場データには /coingecko/markets、モメンタムの確認には /coingecko/trending／/gainers-losers、市場全体の情報には /coingecko/global を使用します。
5. プライベート市場（PitchBook） — /pitchbook/company|fund|investor|advisor|limited-partner で無料のティーザープロフィールページを取得します（クエリパラメーターで対象を指定します。詳細はリファレンスを参照してください）。

すべてのエンドポイント、メソッド、パラメーターについては、reference/endpoints.md を参照してください。

API の呼び出し

# Equities:
scripts/crawlora.sh /yahoo-finance/ticker/AAPL/quote | jq '.'
scripts/crawlora.sh /yahoo-finance/ticker/AAPL/history period=1y interval=1d | jq '.'

# SEC filings (resolve ticker → CIK first):
scripts/crawlora.sh /sec/company/search q="Apple Inc" | jq '.'
scripts/crawlora.sh /sec/company/submissions cik=0000320193 | jq '.'
scripts/crawlora.sh /sec/insider cik=0000320193 | jq '.'

# Congress:
scripts/crawlora.sh /congress/stock-disclosures ticker=NVDA | jq '.'

# Crypto:
scripts/crawlora.sh /coingecko/coin/bitcoin | jq '.'
scripts/crawlora.sh /coingecko/trending | jq '.'

すべてのリクエストには scripts/crawlora.sh を使用してください。API キーをコマンドライン引数に含めずに済みます。

エンドポイントのリファレンス

このスキルで使う Yahoo Finance、SEC EDGAR、Congress、CoinGecko、PitchBook の全エンドポイントについては、reference/endpoints.md を参照してください。

例

• ティッカーの詳細調査： /yahoo-finance/ticker/{symbol}/info + /financials + /analysts + /ticker-news を調べ、監査済み数値と /sec/financials で照合します。
• インサイダー取引の監視： 企業の Form 4 提出書類には /sec/insider を使い、同じティッカーで絞り込んだ /congress/stock-disclosures と併せて、議員も取引していたか確認します。
• 暗号資産のモメンタム分析： /coingecko/gainers-losers に続けて /coingecko/coin/{id} を使い、値上がり・値下がり上位銘柄のファンダメンタルズを確認します。
• VC のデューデリジェンス： ティーザープロフィールには /pitchbook/company、その投資家には /pitchbook/investor を使います。

注意事項と制限

• クレジット／成功時課金： 2xx の場合のみ課金されます。無料枠は月 2,000 クレジットです。 キーは https://crawlora.net で取得してください。
• 公開データのみ — 公開されている株価、提出書類、開示ページが対象です。投資助言ではありません。
• セキュリティ： キーは CRAWLORA_API_KEY のみに保存してください。ハードコード、クエリパラメーターへの設定、コミットは絶対にしないでください。
• PitchBook のプロフィールは無料枠向けの概要です（有料プラットフォームの完全なデータではありません）。 — 各フィールドは網羅的な情報ではなく、参考情報として扱ってください。
• SEC の全文検索は、2001 年以降の提出書類のみを対象としています。