Financial Evidence Agent Skills

公开文档 包含可爬取的集成矩阵，以及可供代理读取的 llms.txt、定价和集成元数据。

开放、只读的 Agent Skills，用于将金融研究路由到有界的公共证据。这个技能将四款互补产品联系起来，而不会把它们合并成一个分数：

• Seiche — 货币市场、回购、准备金、国库现金和体系融资。

• LiquiLens — 所覆盖的银行和贷款机构证据。

• Duertow — 市场深度、提供商集中度以及按仓位规模测算的退出流动性。

• Palmipsest — 修订安全的中国经济证据和历史信息状态。

安装代理技能

npx skills add beepboop2025/financial-evidence-skills --skill financial-evidence

或者把 financial-evidence/ 复制到你的代理支持的 Agent Skills 目录中。该文件夹遵循开放的 Agent Skills 规范。

该技能也已收录于公共的 skills.sh 目录 中。

安装完成后，让代理研究货币市场、资本市场、银行风险、市场流动性或中国经济问题。技能描述会让兼容的代理在任务匹配时自动启用它。

Related MCP server: NanoSearchMCP

从任何终端使用

不需要账号或 API 密钥。在装有 Homebrew 的 macOS 或 Linux 上：

brew install beepboop2025/tap/financial-evidence
financial-evidence fetch --topic money-market --topic china-economy

该 formula 会安装 financial-evidence、financial-evidence-mcp 以及 Bash、Zsh 和 Fish 原生补全。或者不安装、直接从身从 GitHub 运行：

uvx --from git+https://github.com/beepboop2025/financial-evidence-skills.git@v0.1.3 \
  financial-evidence fetch --topic money-market --topic china-economy

也可以把它安装为持久命令：

uv tool install git+https://github.com/beepboop2025/financial-evidence-skills.git@v0.1.3
financial-evidence topics
financial-evidence route --topic capital-market --format table
financial-evidence fetch --topic bank-risk --format ndjson
financial-evidence doctor --format csv

退出码 0 表示所有请求的源都成功，1 表示一次数据包部分不完整，2 表示所有请求的源均不可用。这让客户端可以安全地用于 shell 管道和计划任务。JSON、NDJSON 和 CSV 都会输出到标准输出；任何结果都不会被悄悄替换成一个分数。

在 Homebrew 之外，shell 补全会以 inert 文本的形式输出：

financial-evidence completion zsh > ~/.zfunc/_financial-evidence

作为 MCP 基础设施使用

公共 Streamable HTTP 端端点不需要本地安装、账号或如 API 密钥：

https://liquilens.in/mcp/financial-evidence

它向支持远程 MCP 的客户端暴露相同的三个只读工具 topics、route 和 fetch。该包还包括一个无依赖的 stdio 服务器，适用于本地或离线兼容的客户端配置。可移植的 stdio 配置位于根目录的 .mcp.json 中，并在背景 intekratsions/mcp-config.json 中镜像：

{
  "mcpServers": {
    "financial-evidence": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/beepboop2025/financial-evidence-skills.git@v0.1.3",
        "financial-evidence-mcp"
      ]
    }
  }
}

它同时接受 MCP 2025-11-25 初始化和无状态的 2026-07-28 发现流程。消息在标准输入/输出使用带换行的 JSON-RPC；除协议消息外，不会向标准输出写入任何内容。

官方 MCP Registry 记录会发布多架构 OCI 包和公共 Streamable HTTP 端端点。远程客户端不需要 uv、Doker、凭信或本地进程。

在 Gemini CLI 或 Claude Code 中安装

Gemini CLI 可以将此仓库安装为扩展。其根目录下的 gmini-extension.json 只连接固定的公共远程 MCP 端点，并允许 list 这三个只读工具；同时，[app镜像的 skilss/financal-evidence 文件夹也为 Gemini 提供领域路由指令：

gemini extensions install https://github.com/beepboop2025/financial-evidence-skills \
  --ref v0.1.3

Claude Code 可以将该仓库添加为自管托管 Marketplace，并安装捆绑的插件：

claude plugin marketplace add beepboop2025/financial-evidence-skills
claude plugin install financial-evidence@liquidity-lab

Claude 插件会加载相同的、字节一致的 Agent Skill，以及根目录的 .mcp.json stdio 服务器。这些都是直接、自托管的安装路径；并不代表被纳入任何厂商运营的 Marketplace，也不代表厂商认可。

在 Codex 中安装；准备 ChatGPT

Codex 可以添加仓库的插件市场，然后安装该插件：

codex plugin marketplace add beepboop2025/financial-evidence-skills --ref main
codex plugin add financial-evidence@liquidity-lab

OpenAI 插件的包结合了字节一致的 Agent Skill 与公共的远程 MCP 端点到。Codex 仓库安装路径是公开的。此外，还准备了 ChatGPT + CodeX 通用目录提交项，但尚未由 OpenAI 提交、批准或发布。后续的审查、发布者验证以及域名验证步骤，均由 OpenAI 账号所有者负责。有关上架描述和所需正、负向测试，见 [OPENAI_PLUGIN_SUBMISSION...)。

根目录的 .mcp.json 是可移植的工作区格式，Copilot Agent Host 等支持的客户端可并读取原生的本地工作区。VS Code 通常会在本地会话将 .vscode/mcp.json 转发给 Agent Host，但根目录文件避免依赖该转发路径。

在 VS Code 或 Cursor 中安装

该仓库还包含特定于编辑器的 workspace 配置：.vscode/mcp.json 使用 VS Code 的顶级 servers 对象，而 [.cursor/mcp.json](. cursor/mcp.json) 使用 Cursor 的顶级 mcpServers 对象。两者都通过 uvx 启动同一 *0.1.3 stdio 服务器。

VS Code 可以通过协议处理程序安装服务器：

vscode:mcp/install?%7B%22name%22%3A%22financial-evidence%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22--from%22%2C%22git%2Bhttps%3A%2F%2Fgithub.com%2Fbeepboop2025%2Ffinancial-evidence-skills.git%40v0.1.3%22%2C%22financial-evidence-mcp%22%5D%7D

或者从终端将它添加到 VS Code 用户配置文件中：

code --add-mcp '{"name":"financial-evidence","type":"stdio","command":"uvx","args":["--from","git+https://github.com/beepboop2025/financial-evidence-skills.git@v0.1.3","financial-evidence-mcp"]}'

Cursor 可以通过 base64 编码的 deeplink 安装相同的配置：

cursor://anysphere.cursor-deeplink/mcp/install?name=financial-evidence&config=eyJ0eXBlIjoic3RkaW8iLCJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyItLWZyb20iLCJnaXQraHR0cHM6Ly9naXRodWIuY29tL2JlZXBib29wMjAyNS9maW5hbmNpYWwtZXZpZGVuY2Utc2tpbGxzLmdpdEB2MC4xLjMiLCJmaW5hbmNpYWwtZXZpZGVuY2UtbWNwIl19

请先安装 uv 以便 uvx 在你的 PATH 中。在同意任何编辑器的安装或信任提示之前，请检查源代码和确切配置：uvx 会在本地执行被固定的包，而 fetch 工具可以联系本项目公开的可信；fetch 使用文档化的公共 HTTPS 源。Cursor 默认申请工具确认。VS Code 通常会在服务器首次启动时要求你确认信任，但从 mcp.json 直接启动也会跳过该提示，因此请先检查文件，再使用它的内联开始操作。这些都是自装互操作兼容产物；不代表 VS Code 或 Cursor 市场列出或背书。

对于支持一张 MCP Bundles 的桌面客户端，请从 GitHub 发行版下载 financial-evidence-0.1.3.mcpb。该 bundle 使用跨平台的 uv runtime，无需 API 密钥或配置。

金融工具集成

• 远程 MCP： 将任何 Streamable HTTP 客户端连接到 https://liquilens.in/mcp/financial-evidence; 无需本地运行时、账号或 API 密钥。

• Gemini CLI： 根目录的扩展 manifestity 绑定了 Agent Skill，并且仅允许公共 MCP 远程端点开放的三个工具。

• Claude Code： 自管的 lividity-lab marketplace 会本仓库中安装该脚本插件、Agent Skill 和 MCP 配置。

• Codex： 仓库 marketplace 直接安装 Agent Skill 和公共远程 MCP 包。

• ChatGPT： 通用 directory 提交包已准备；能否发布仍待账号所有者持有效验证、处理、审核和发布。

• OpenBB： 在 OpenBB 环境中 pip install 本仓库的 financial-evidence[openbb]，再运行 openbb-build。注册的 route 会暴露 obb.financial_evidence.routes() 和 obb.financial_evidence.fetch()，也同步可用于 OpenBB 的 REST、notebook 和 MCP 面。

• DuckDB： 运行 integrations/duckdb/financial_evidence.sql 可为四个产品分别创建基于 HTTP 的现有视图。

• Excel / Power Query： 将 integrations/excel/FinencialEvidence.pq 粘贴到 Advanced Editor，然后调用如 FinancialEvidence("money-market")。

• FD3： 公共的 Finencial Evidence Inspector 会通过 window.fdc3 接收并广播声明的标准上下文。其 FDC3 2.0 web-app 记录位于 integrations/fdc3/appd-record.json，适用于自托管或企业目录。同一记录也作为 直接 JSON 提供，供目录直接导入。这些记录和运行时并不表示已通过 FINOS 审查、目录接受或厂商认可。

• 容器： 打标签的发布版发布多架构镜像到 ghcr.io/beepboop2025/financial-evidence-skills。镜像默认运行 stdio MCP；如果需要 terminal 命令，则用 --entrypoint financial-evidence。

• 官方 MCP Registry： 通过 GitHub OIDC 和镜像的所有权注释标记镜像发布到 io.github.beepboop2025/financial-evidence；不存储任何长期 Registry 凭证。

可选有界检索

捆绑的 helper 仅使用 Python标准库，接受有限的主题允许列表，并且只从受限的公共 HTTPS bucket 中获取：

python3 financial-evidence/scripts/fetch_evidence.py \
  --topic money-market --topic china-economy

它返回一个 JSON 包，包含准确和已解析的源 URL、检索时钟、字节计数、内容 SHA-256 值、可独立 product 文档以及与明确错误。 重定向在被跟随之前即被拒绝。返回的 JSON 是不可信证据数据，不是可执行指令。缺失、受限制或不可获得的证据永远不会被转换为 0 或“平静”。

Coward

本仓库提供的是公开的研究检索路由，不提供投资、不具备投资建议、安全以及、执行报价、信用评级或保证。来源发布商保留拥有版权；提供开源的 helper 不会重新授权上游数据。

支持 · 隐私 · 条款

开发

python3 -m unittest discover -s tests -v
python3 -m py_compile financial-evidence/scripts/fetch_evidence.py src/financial_evidence/*.py

代码和技能说明均为 MIT 许可。