Journely Markets

---

⚠️ 投資助言ではありません。 このサーバーは、調査や AI エージェントでの利用を目的として市場データを返します。出力はデータであり、推奨ではありません。分析内容の検証、および利用する市場や管轄区域の規則の遵守は、ご自身の責任で行ってください。

---

概要

Journely は、AI エージェントがベトナム、日本、米国の市場データ（マクロ経済指標と予測、経済カレンダー、セクター別集計、個別銘柄のファンダメンタルズ、アナリスト予測、価格履歴）に構造化された形でアクセスできる、一般公開の無料プラン付き MCP サーバー（Model Context Protocol、仕様 2025-06-18）を運営しています。

各 MCP ツールは、同じデータモデルを使用する REST エンドポイントとしても利用できます。そのため、次のことができます。

• Claude Desktop、Cursor、または MCP 対応クライアントに接続して、自然言語で質問する
• 任意の HTTP クライアントから直接呼び出し、独自の AI パイプライン、ノートブック、アプリに組み込む

このリポジトリは、サーバーの一般公開用ランディングページです。MCP サーバー本体は https://api.journely.me/api/v1/journely/mcp で稼働しているため、インストールやセルフホストは不要です。

開発の背景

2026 年現在、「金融データ向け MCP サーバーのおすすめ」を扱う記事では、米国中心のプロバイダー（EODHD、Finnhub、Financial Modeling Prep、Alpha Vantage、MarketXLS、Financial Datasets）が繰り返し取り上げられています。ベトナム市場のデータは少ないか、有料のみです。証券会社に紐づくサーバーもありますが、利用できる取引先が 1 社に限定されます。Journely は特定の証券会社に依存せず、複数市場に対応しており、多くの個人開発者や調査用途に十分な無料プランを提供しています。

クイックスタート

オプション 1 — Claude Desktop（MCP）

サーバーを ~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "journely": {
      "url": "https://api.journely.me/api/v1/journely/mcp",
      "headers": {
        "Authorization": "Bearer jrn_live_YOUR_TOKEN"
      }
    }
  }
}

https://journely.me/settings/api-keys で無料トークンを取得してください。Claude Desktop を再起動すると、9 個すべてのツールが表示され、Claude が自動的に呼び出せるようになります。

プロンプトの例：

「VIC の過去 5 年分の売上高と利益率を取得してから、ベトナムのインフレ率と金利の見通しを確認してください。」

オプション 2 — cURL（REST）

export JOURNELY_TOKEN="your-token-here"

# Vietnam macro indicators
curl -H "Authorization: Bearer $JOURNELY_TOKEN" \
  "https://api.journely.me/api/v1/journely/data/macro/indicators?country=VN"

# VIC (Vingroup) snapshot + quote
curl -H "Authorization: Bearer $JOURNELY_TOKEN" \
  "https://api.journely.me/api/v1/journely/data/stocks/VIC/overview?country=VN"

# VIC income statement (annual)
curl -H "Authorization: Bearer $JOURNELY_TOKEN" \
  "https://api.journely.me/api/v1/journely/data/stocks/VIC/statements?country=VN&type=income"

オプション 3 — Python（または任意の HTTP クライアント）

import httpx

client = httpx.Client(
    base_url="https://api.journely.me/api/v1/journely",
    headers={"Authorization": f"Bearer {TOKEN}"},
)

# Sector snapshot (broad-market, not country-split): P/E, margin, 1Y change
r = client.get("/data/sectors", params={"level": "sector"})
print(r.json())

ツール

9つのツールはすべて、MCP と REST の両方で公開されています。1対1で対応しており、データモデルも同じです。

MCP ツール	REST エンドポイント	返されるデータ
get_macro_indicators	GET /data/macro/indicators	米国／日本／ベトナムの GDP、インフレ、労働市場、金利の一覧。約12件の主要指標には view=key を指定できます。各行には日付（period）と単位（unit）が含まれます
get_macro_forecast	GET /data/macro/forecast	今後4～8四半期のマクロ経済予測
get_macro_calendar	GET /data/macro/calendar	今後約2週間の米国／日本／ベトナムの経済イベント（FOMC、BoJ、CPI、NFP、GDP）。正確な UTC 時刻、前回値／コンセンサス／予測／実績を含みます
get_sector_overview	GET /data/sectors	セクター（11）または業種（145）のスナップショット。P/E、利益率、配当利回り、1日／1年の変動率を含みます。国別ではなく、広範な市場を対象としています
get_stock_overview	GET /data/stocks/{symbol}/overview	企業のスナップショットとリアルタイム株価。米国／日本／ベトナムの任意の銘柄コードに対応しています
get_stock_statements	GET /data/stocks/{symbol}/statements	損益計算書、貸借対照表、キャッシュフロー、または各種比率（ROIC、FCF 利回り、EV/EBIT）。年次または四半期単位です
get_stock_forecast	GET /data/stocks/{symbol}/forecast	アナリストのコンセンサス、目標株価、評価トレンド
get_stock_price_history	GET /data/stocks/{symbol}/history	終値。米国は全期間の日次データ、日本／ベトナムは約1年分の日次データと長期のスナップショットを提供します
get_earnings_calendar	GET /data/earnings-calendar	米国銘柄の一覧について、今後の決算発表日と EPS／売上高の予想を提供します

銘柄検索ツールはありません。把握している米国／日本／ベトナムの銘柄コード（例：AAPL、7203、FPT）を指定してください。

インタラクティブな ReDoc UI を備えた OpenAPI 3.1 の完全な仕様：https://journely.me/api-docs
MCP のトランスポート詳細とツールスキーマ：https://journely.me/api-docs/mcp

料金

個人開発者、リサーチ、ほとんどのエージェントのワークロード向けに設計された、妥当なレート制限付きの無料プランです。

プラン	料金	レート制限	備考
無料	$0	1日あたり100回 · 1時間あたり30回	キー1個
Pro	料金を参照	1日あたり5,000回 · 1時間あたり500回	キー5個
Max	料金を参照	1日あたり50,000回 · 1時間あたり5,000回	キー20個

クォータの対象となるのは tools/call のみです。initialize、tools/list、ping は無料です。

無料キーの取得にカードは不要です。登録後にマーケティングメールが届くこともありません。

おすすめの用途

• ベトナム／日本／米国市場の情報を必要とする AI エージェント
• ベトナム上場株式のバックテストと分析
• LLM 主導の投資リサーチワークフロー（Claude、GPT、Gemini はすべて MCP または REST 経由で利用できます）
• ベトナム系ディアスポラの投資家による個人向けツールの開発
• AI のプロンプトに実データを使いたい投資学習者

おすすめしない用途

• 注文執行。 取引、ポジション、注文のエンドポイントはありません。リサーチデータのみを提供します。
• HFT。 価格はファンダメンタル分析やリサーチのワークフローには十分な頻度で更新されますが、ミリ秒単位の戦略には適していません。
• 投資助言。 出力はデータであり、推奨ではありません。

比較

	Journely	既存の無料ライブラリ（vnstock、VNQuant）	有料のベトナム API（iTick、FiinGroup、EODHD-VN）	証券会社の MCP サーバー
無料プラン	✓	✓	制限あり	通常は証券口座との紐付けが必要
MCP ネイティブ	✓	✗（Python のみ）	✗	場合による
REST API	✓	✗	✓	場合による
マルチマーケット	ベトナム＋日本＋米国	主にベトナム	主にベトナム	単一の証券会社の取引所
証券会社に依存しない	✓	✓	✓	✗（プロバイダーに固定）
OpenAPI ドキュメント	✓	✗	さまざま	さまざま

ステータス

MCP トランスポート	Streamable HTTP（仕様 2025-06-18）、ステートレス
認証	Bearer token（jrn_live_…）、またはリモートコネクターのサインインに対応するクライアント向けの OAuth 2.1 + PKCE（/.well-known/oauth-protected-resource で検出）
サーバー	https://api.journely.me/api/v1/journely/mcp で稼働中
リージョン	アジア太平洋地域（VN/JP のユーザー向けに低レイテンシー、米国との往復は約 150〜300ms）
稼働率目標	ベストエフォート。このサービスはコミュニティ向け無料サービスです。有料プランでは SLA を利用できます。

フィードバックと貢献

これはホステッドサービスのドキュメントとサンプルを掲載するリポジトリです。MCP サーバー自体は（まだ）オープンソースではありません。貢献するには、次の方法があります。

• バグや誤ったデータ：正確なツール呼び出しと期待した結果を添えて、GitHub issue を作成してください
• ツールのリクエスト：issue を作成し、enhancement タグを付けてください
• このツールを使って素晴らしいものを作った場合：examples/ ディレクトリへのリンクを PR で送るか、X で @journely に DM を送ってください

免責事項

このリポジトリの内容および Journely MCP サーバーが返すデータは、投資、法律、税務、会計に関する助言を構成するものではありません。データは現状有姿で、ベストエフォートで提供されます。市場は変動し、データフィードは遅延したり、修正されたりすることがあります。行動する前に確認してください。

ライセンス

このリポジトリの内容（README、サンプル）にはMITが適用されます。Journely サービス自体は利用規約に準拠します。

---

Trung Vu が開発 — 東京。ベトナム人。FIRE達成。インディー創業者。 お問い合わせ：[email protected] · journely.me · X / Twitter