Journely Markets

---

⚠️ 不构成投资建议。 此服务提供市场数据，用于研究和 AI Agent。输出内容是数据，不是建议。您有责任核实任何分析，并遵守所在市场和司法管辖区的相关规定。

---

服务介绍

Journely 运营一个公开的免费层 MCP 服务（Model Context Protocol，规范 2025-06-18），为 AI Agent 提供对越南、日本和美国市场数据的结构化访问，包括宏观指标和预测、经济日历、行业汇总，以及个股基本面、分析师预估和价格历史。

每个 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）。越南市场的覆盖有限，或仅提供付费服务；与券商绑定的服务虽已存在，却会将您限制在单一执行场所。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 提供，二者一一对应，使用相同的数据模型。

MCP 工具	REST 端点	返回内容
get_macro_indicators	GET /data/macro/indicators	美国 / 日本 / 越南的 GDP、通胀、劳动力和利率面板——view=key 可查看约 12 项主要指标；每行均标注日期（period）和单位（unit）
get_macro_forecast	GET /data/macro/forecast	前瞻性宏观预测（4–8 个季度）
get_macro_calendar	GET /data/macro/calendar	美国 / 日本 / 越南未来约两周的经济事件（FOMC、BoJ、CPI、NFP、GDP），包含精确的 UTC 时间、前值 / 共识 / 预测 / 实际值
get_sector_overview	GET /data/sectors	板块（11 个）或行业（145 个）概览——市盈率、利润率、股息率、1D / 1Y 涨跌幅。涵盖整体市场，不按国家拆分
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）。

完整的 OpenAPI 3.1 规范及交互式 ReDoc UI：https://journely.me/api-docs MCP 传输详情和工具架构：https://journely.me/api-docs/mcp

定价

免费套餐提供合理的速率限制，适合独立开发者、研究用途和大多数 Agent 工作负载。

套餐	价格	速率限制	备注
Free	$0	100 / 天 · 30 / 小时	1 个密钥
Pro	参见定价	5,000 / 天 · 500 / 小时	5 个密钥
Max	参见定价	50,000 / 天 · 5,000 / 小时	20 个密钥

只有 tools/call 会计入配额——initialize、tools/list 和 ping 均免费。

获取免费密钥无需信用卡。注册后不会收到营销邮件。

适用场景

• 需要越南 / 日本 / 美国市场背景信息的 AI Agent
• 对越南上市股票进行回测和分析
• 由大模型驱动的投资研究工作流（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

免责声明

本仓库或 Journely MCP 服务返回的数据均不构成投资、法律、税务或会计建议。数据按原样提供，并尽力确保其准确性。市场瞬息万变；数据源偶尔会延迟或更正。采取行动前请先核实。

许可证

本仓库内容（README、示例）采用 MIT 许可证。Journely 服务本身受其服务条款约束。

---

由 Trung Vu 构建 — Tokyo。Vietnamese。已实现 FIRE。独立创始人。 联系：[email protected] · journely.me · X / Twitter