关于 ddbx — insider dealings
ddbx — insider dealings 是用于查询英国、美国、瑞典、荷兰及美国国会评级内幕交易的只读套件。它将公开 MCP 服务与三种技能打包,分别用于公司活动、市场扫描和每日摘要。
主要功能
- 01按公司搜索内幕交易
- 02按时间扫描市场重要交易
- 03获取英国和美国每日摘要
- 04查看公司及交易记录
- 05提供三种内置研究技能
适用场景
- 01查看某公司的近期董事买入
- 02回顾市场上的重要内幕交易
- 03查询某时期美国国会的交易
- 04阅读英国或美国每日摘要
MCP 相关
该套件连接到 https://api.ddbx.uk/mcp 上的公开只读 MCP 服务,无需 API 密钥。服务提供搜索和获取交易、公司数据及每日摘要的工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://api.ddbx.uk/mcpclaude mcp add --transport http jonwillington-ddbx https://api.ddbx.uk/mcp{"mcpServers":{"jonwillington-ddbx":{"type":"http","url":"https://api.ddbx.uk/mcp"}}}在 Cursor 中打开{"servers":{"jonwillington-ddbx":{"type":"http","url":"https://api.ddbx.uk/mcp"}}}在 VS Code 中打开{"mcpServers":{"jonwillington-ddbx":{"type":"http","url":"https://api.ddbx.uk/mcp"}}}{"mcpServers":{"jonwillington-ddbx":{"serverUrl":"https://api.ddbx.uk/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
6| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| limit | integer | 否 | |
| since | string | 否 | 仅包含在此日期或之后披露的申报。 |
| before | string | 否 | 仅包含在此日期之前披露的申报(用于向前翻页)。 |
| market | enum | 是 | UK = LSE 董事;US = SEC Form 4 内部人士;SE = 瑞典;NL = 荷兰;USG = 美国国会议员。UK | US | SE | NL | USG |
| ticker | string | 否 | 发行方股票代码,例如 "BARC" 或 "BARC.L"(UK)、"NVDA"(US)。 |
| signal_only | boolean | 否 |
详细介绍
ddbx 插件(ChatGPT + Codex)
一个 Agent Plugins 1.0 软件包, 可将 ddbx 内部人士交易信息接入 ChatGPT 和 Codex。它包含:
- ddbx MCP 服务(
https://api.ddbx.uk/mcp):只读、无需身份验证,仅限 thin 层。服务位于ddbx-data/worker/mcp.ts;本仓库仅指向它。 - 三个技能,用于指导助手如何有效使用这些工具:
company-insiders:单家公司(英国、美国、SE、NL、Congress)的内部人士活动market-scan:一段时间内市场上的重要交易daily-recap:ddbx 发布的英国或美国每日摘要
.agents/plugins/marketplace.json repo marketplace, so Codex can add this repo directly
plugins/ddbx/
plugin.json root manifest, with the com.openai interface block
mcp.json the remote MCP server
skills/<name>/SKILL.md workflows
skills/<name>/agents/openai.yaml display name + MCP dependency per skill
assets/icon.png, logo.png from ddbx-site/public/ios-app-icon-uk.png
SUBMISSION.md listing copy and test cases for the submission portal
连接
托管服务公开、只读且无需 API 密钥:
https://api.ddbx.uk/mcp。
- Claude: 自定义 → 连接器 → 添加自定义连接器 → 粘贴 URL。
- Cursor / VS Code: 添加一个名为
ddbx、URL 为该地址的 HTTP MCP 服务。 - Claude Code:
claude mcp add --transport http ddbx https://api.ddbx.uk/mcp - Gemini CLI:
gemini extensions install https://github.com/jonwillington/ddbx-plugin - Codex:
codex plugin marketplace add jonwillington/ddbx-plugin - Smithery:
jonathanwillington/ddbx
本仓库还包含适用于官方 MCP Registry、Cursor Marketplace、Gemini CLI 和 OpenAI Agent Plugins 的清单。
与 ddbx-data 的约定
这些技能列出了 MCP 工具(search_dealings、get_dealing、get_company、
get_daily_summary、search、fetch)及其参数。在 worker/mcp.ts 中重命名工具或参数,
会导致此插件以及任何缓存的连接器无法正常工作:请以添加方式变更,然后更新此处的技能。
这些技能也重申了 thin 层的限制:服务不会提供分析正文,因此助手会链接到每份申报文件的 url,
绝不会臆造评级理由。如果 MCP 将来在身份验证后提供分析,请更新 Rules 部分。
在 Codex 中测试
codex plugin marketplace add ./ # from this repo root
codex plugin marketplace list
然后在 ~/.codex/config.toml 中启用它:
[plugins."ddbx@ddbx"]
enabled = true
试试:“英国董事今天买了什么?”、“Dunelm 有内部人士买入吗?” “Congress 在 NVDA 上进行了哪些交易?”
此仓库发布到 GitHub 后:codex plugin marketplace add jonwillington/ddbx-plugin。
在 ChatGPT 中测试
-
设置 → 安全与登录 → 开启 开发者模式。
-
ChatGPT Plugins → + → 服务 URL
https://api.ddbx.uk/mcp,身份验证选择 None。 -
从浏览器 URL 中复制
plugin_asdk_app_…ID。 -
如需将技能打包到其中,请添加
plugins/ddbx/.app.json:{ "apps": { "ddbx": { "plugin_asdk_app_<id>": {} } } }并在
plugin.json的extensions.com.openai中加入"apps": "./.app.json"。 -
在 Work 聊天中使用
@ddbx进行测试。
发布
- 你的工作区:ChatGPT Plugins → Personal → 插件的 ⋯ 菜单 → Publish。 这不会将其公开列出。
- 公开目录:通过提交门户提交。
需要经过验证的开发者身份,以及通过
https://api.ddbx.uk/.well-known/openai-apps-challenge提供的域名验证文件(需更改 ddbx-data)。 列表介绍文案和所需测试用例见SUBMISSION.md。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。