simplywallst

SimplyWallSt — 株式リサーチとSnowflakeスコア

SimplyWallSt のデータを、内部REST API（simplywall.st/api/...）を使って取得します。Cloudflare不要、APIキー不要、登録不要です。

世界中の120,000以上の銘柄のSnowflakeスコア（value、income、health、past、future、management）、バリュエーション分析、過去および予測配当、財務健全性スコア、インサイダー取引などを取得できます。

---

⚠️ 免責事項

• SimplyWallSt に公式の公開APIはありません。このスキルではWebフロントエンドの内部エンドポイントを使用します。
• サイトの利用規約を遵守してください。
• レート制限を実装してください（リクエスト間の待ち時間は最低300ms）。

---

インストール

pip install requests

---

スクリプト

スクリプト	説明
fetch_sws.py	完全なクライアント：ティッカー一覧、企業の詳細、Snowflakeスコア、分析

---

クイックスタート

# PRIMERO: Descargar snapshot de tickers (1 vez sola, ~5 min)
python scripts/fetch_sws.py --download-snapshot

# Luego: las búsquedas por ticker usan el snapshot → instantáneas
python scripts/fetch_sws.py --ticker GGAL

# Buscar por nombre
python scripts/fetch_sws.py --search "Galicia"

# Full data con todos los includes (info, score, analysis, extended, raw_data, insider)
python scripts/fetch_sws.py --ticker GGAL --full

# Listar empresas (grid)
python scripts/fetch_sws.py --grid --size 10

# Listar solo tickers disponibles (Argentina)
python scripts/fetch_sws.py --list-tickers --country AR --output tickers_ar.csv

# Snowflake scores de múltiples tickers
python scripts/fetch_sws.py --ticker GGAL,BMA,SUPV --score

# Output a archivo
python scripts/fetch_sws.py --ticker GGAL --full --output ggal_data.json

---

検出済みエンドポイント

エンドポイント	メソッド	データ	ステータス
/api/grid/filter?include=info,score,grid	POST	スコアと指標を含む企業一覧	✅ 動作します
/api/company{canonical_url}	GET	企業の完全な詳細情報	✅ 動作します

Company Detail で利用可能なInclude

Include	データ
info	企業プロフィール、業界、国、従業員数、CEO
score	Snowflakeスコア（value、income、health、past、future、management）
analysis	価格、時価総額、P/E、P/B、ROE、ROA、EPS、配当、成長率
analysis.extended	過去の配当、配当性向、自社株買い、将来のEPS
analysis.extended.raw_data	過去の財務諸表
analysis.extended.raw_data.insider_transactions	インサイダー取引

---

対応範囲

特徴	詳細
世界中の株式	90以上の市場に120,000銘柄以上
アルゼンチン市場	✅ BASE（BCBA）のティッカー：GGAL、BMA、SUPV、YPFDなど
米国市場	✅ NasdaqGS、NYSE、AMEX
更新頻度	毎日（終値）
Snowflakeスコア	Value、Income、Health、Past、Future、Management
配当	19年以上の過去データ、将来予測
インサイダー取引	✅（利用可能な場合）
アナリスト	コンセンサスの件数と目標株価

---

スクリプトのフラグ

フラグ	説明
--ticker TICKER	カンマ区切りのティッカー：GGAL または GGAL,BMA
--search QUERY	名前で検索
--full	利用可能なすべてのInclude
--score	Snowflakeスコアのみ
--info	企業情報のみ
--analysis	分析指標のみ
--extended	拡張データを含める
--raw-data	財務のraw dataを含める
--grid	grid/filter経由で企業を一覧表示
--list-tickers	利用可能なティッカーを一覧表示
--country AR	国で絞り込む（--gridのみ）
--size N	ページサイズ（デフォルト：24）
--limit N	結果の上限
--download-snapshot	ティッカーの完全なスナップショットをassets/にダウンロード
--snapshot PATH	特定のスナップショットを使用（デフォルト：assets/内を自動検索）
--output archivo.json	出力を保存
--csv	CSV形式で出力
--delay N	リクエスト間の待ち時間（デフォルト：0.3秒）

---

データの種類別の例

Snowflakeスコア

python scripts/fetch_sws.py --ticker GGAL --score
# → value=0, income=0, health=4, past=1, future=5, management=0
# → "High growth potential with adequate balance sheet."

企業情報

python scripts/fetch_sws.py --ticker GGAL --info
# → name, industry (Banks), country (AR), employees (10032), year_founded (1905)

分析＋配当

python scripts/fetch_sws.py --ticker GGAL --analysis --extended
# → P/E, P/B, ROE, ROA, EPS, Debt/Equity, market cap
# → dividend history, payout ratios, future yield

すべてのデータ

python scripts/fetch_sws.py --ticker GGAL --full

---

grid/filter を使う

grid/filterは、情報＋スコア＋grid指標を含むすぐに利用できる企業データを1回のリクエストで返します。スクリーナーに最適です。

# Todas las empresas (default: market cap desc)
python scripts/fetch_sws.py --grid --limit 50

# Top 10 Argentina
python scripts/fetch_sws.py --grid --size 10

注： grid/filterでは、国やティッカーによる直接の絞り込みはできません。--list-tickersと--countryを使ってクライアント側で絞り込んでください。

---

ティッカーのスナップショット（推奨）

スナップショットは、利用可能なすべての上場銘柄を含むローカルCSVファイルです。グリッドを反復せずに、ティッカーをすぐに解決できます。

スナップショットをダウンロード（1回のみ、約10分）

# Descarga completa (~10 min, genera assets/YY-MM-DD-ticker-snapshot.csv)
python scripts/fetch_sws.py --download-snapshot

スナップショット全体の仕組み

API の 1 クエリあたりの上限は 10,000 レコードです。すべて取得するために、スクリプトでは 取引所ごとに分割します。

1. フェーズ 1：デフォルトのクエリで上位 10K を取得 → 利用可能な取引所を抽出します
2. フェーズ 2：各取引所について、企業をすべて取得します（各取引所のレコード数は 10K 未満です）
3. 重複排除：すべてを統合し、unique_symbol（取引所 + ティッカー）で重複を削除します

スナップショット 26-06-04 の結果

指標	値
一意な上場銘柄の合計（unique_symbol）	78,454
対象国	83
取引所	106
重複排除処理での重複	0
リクエスト総数	約944
所要時間	約11分
CSV サイズ	約6 MB

なぜ 54K ではなく 78K なのですか？ デフォルトのクエリ（最低スコアでフィルタリング）に対して、API は total_records=54,530 を報告します。しかし、よりシンプルなルール（exchange_symbol=X + primary_flag=true）で取引所ごとに分割すると、はるかに多くの結果が得られます。ETF、ファンド、スコアのない企業、ADR などが含まれます。54K は、デフォルトのフィルター条件を満たすものだけです。

データ品質の検証

チェック項目	結果
unique_symbol の重複	0 — 重複排除は 100% 有効です
同じティッカー + 同じ取引所の重複	3 件 — すべて誤検出です（先頭のゼロ：115 ≠ 0115）
複数の取引所に上場しているティッカー	8,751 — 正常です。複数の市場に上場している企業です
上場銘柄数が多い国	US（16,274）、CN（7,016）、IN（6,074）、CA（5,221）、JP（4,764）

スナップショットがない場合

スナップショットがない場合、--ticker GGAL はグリッドを走査するため、約30秒かかります。スナップショットがあれば、瞬時に完了します。

スナップショットの形式

フィールド	説明
ticker_symbol	シンボル（GGAL、BMA、MSFT など）
name	企業名
exchange_symbol	取引所（BASE、NasdaqGS、NYSE）
canonical_url	企業詳細情報の API パス
unique_symbol	取引所 + ティッカー（一意のキー）
country	国の ISO コード
industry	業種
employees	従業員数
year_founded	設立年
score_value/income/health/past/future/management/total	Snowflake スコア
share_price	現在の株価
market_cap	時価総額（現地通貨）
pe_ratio、pb_ratio	倍率

特定のスナップショット

python scripts/fetch_sws.py --snapshot assets/26-06-04-ticker-snapshot.csv --ticker GGAL

---

取引所 → 国の対応表

取引所	国	上場銘柄数	説明
OTCPK	US	6,138	OTC Markets Pink（米国）
TSE	JP	4,693	Tokyo Stock Exchange（日本）
BSE	IN	3,833	BSE India（旧 Bombay SE）
SZSE	CN	3,723	Shenzhen Stock Exchange（中国）
SHSE	CN	3,293	Shanghai Stock Exchange（中国）
SEHK	HK	3,019	Hong Kong Exchange
NYSE	US	2,574	New York Stock Exchange
ASX	AU	2,527	Australian Securities Exchange
TSX	CA	2,381	Toronto Stock Exchange（カナダ）
NasdaqGM	US	2,304	NASDAQ Global Market
NSEI	IN	2,241	National Stock Exchange of India
KOSE	KR	2,075	Korea Exchange（KOSPI）
TSXV	CA	1,999	TSX Venture Exchange（カナダ）
KOSDAQ	KR	1,997	KOSDAQ（韓国）
LSE	GB	1,963	London Stock Exchange
NasdaqCM	US	1,854	NASDAQ Capital Market
BATS	US	1,575	BATS Exchange（米国）
NasdaqGS	US	1,532	NASDAQ Global Select
BME	ES	1,514	Bolsas y Mercados Españoles
TPEX	TW	1,430	Taipei Exchange（台湾）
AIM	GB	1,310	AIM（London Stock Exchange）
TWSE	TW	1,292	Taiwan Stock Exchange
KLSE	MY	1,172	Bursa Malaysia
ENXTPA	FR	1,147	Euronext Paris
XTRA	DE	1,135	Xetra（Deutsche Börse）
BOVESPA	BR	1,120	B3（ブラジル）
TASE	IL	1,029	Tel Aviv Stock Exchange
SET	TH	993	Stock Exchange of Thailand
IDX	ID	985	Indonesia Stock Exchange
OM	SE	852	OMX Nordic（ストックホルム）
WSE	PL	849	Warsaw Stock Exchange
OB	NO	811	Oslo Børs（ノルウェー）
CNSX	CA	777	Canadian Securities Exchange
JSE	ZA	754	Johannesburg Stock Exchange
DB	DE	648	Deutsche Börse（フランクフルト）
SNSE	CL	647	Santiago Stock Exchange（チリ）
CPSE	DK	636	Copenhagen Stock Exchange
BIT	IT	625	Borsa Italiana
SWX	CH	588	SIX Swiss Exchange
IBSE	IE	577	Irish Stock Exchange
HOSE	VN	572	Ho Chi Minh Stock Exchange
HNX	VN	417	Hanoi Stock Exchange
SGX	SG	398	Singapore Exchange
DSE	BD	443	Dhaka Stock Exchange
DFM	AE	70	Dubai Financial Market
ADX	AE	85	Abu Dhabi Securities Exchange
BASE	AR	84	Bolsa de Buenos Aires（アルゼンチン）
BMV	MX	147	Bolsa Mexicana de Valores
BVL	PE	102	Bolsa de Valores de Lima（ペルー）
BVC	CO	56	Bolsa de Valores de Colombia
...	...	...	全106取引所

106取引所の完全な対応表は、references/REFERENCE.mdにあります。

---

スキルの構成

skills/simplywallst/
├── SKILL.md                              # Este archivo
├── references/
│   └── REFERENCE.md                      # Documentación completa de endpoints y data
├── scripts/
│   └── fetch_sws.py                      # Script principal
└── assets/
    └── YY-MM-DD-ticker-snapshot.csv      # Snapshot de tickers (generado)

---

📖 詳細なドキュメント： 応答例、フィールド、技術的な注意事項を含む詳細なドキュメントについては、references/REFERENCE.mdを参照してください。