ddbx — insider dealings

ddbx プラグイン（ChatGPT + Codex）

ddbx のインサイダー取引情報を ChatGPT と Codex で利用できるようにする、Agent Plugins 1.0 パッケージです。以下が含まれています。

• ddbx MCP サーバー（https://api.ddbx.uk/mcp）：読み取り専用、認証不要、thin ティアのみです。サーバーは ddbx-data/worker/mcp.ts にあり、このリポジトリはその参照先を指定するだけです。
• 3 つのスキル：ツールをうまく使う方法をアシスタントに教えます。
  • company-insiders：1 社のインサイダー取引状況（UK、US、SE、NL、Congress）
  • market-scan：一定期間における市場全体の注目すべき取引
  • daily-recap：ddbx が公開する UK または US の日次サマリー

.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： Customize → Connectors → Add custom connector → URL を貼り付けます。
• Cursor / VS Code： URL を指定して、ddbx という名前の 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

次のように試してみてください：「今日、UK の取締役は何を購入しましたか？」「Dunelm でインサイダーによる買い付けはありましたか？」「Congress は NVDA でどのような取引をしましたか？」

このリポジトリを GitHub に公開したら、codex plugin marketplace add jonwillington/ddbx-plugin を実行します。

ChatGPT でテストする

1. Settings → Security and login → Developer mode をオンにします。

2. ChatGPT Plugins → + → サーバー URL https://api.ddbx.uk/mcp、認証は None を選択します。

3. ブラウザーの URL から plugin_asdk_app_… ID をコピーします。

4. スキルを同梱するには、plugins/ddbx/.app.json を追加します。

   { "apps": { "ddbx": { "plugin_asdk_app_<id>": {} } } }
   

   次に、plugin.json の extensions.com.openai 内に "apps": "./.app.json" を追加します。

5. Work チャットで @ddbx を使ってテストします。

公開

• 自分のワークスペース： ChatGPT Plugins → Personal → プラグインの ⋯ メニュー → Publish。 これによって一般公開されることはありません。
• 公開ディレクトリ： 申請ポータル。 認証済みの開発者 ID と、https://api.ddbx.uk/.well-known/openai-apps-challenge で提供されるドメインチャレンジ（ddbx-data の変更）が必要です。 掲載文と必須のテストケースは SUBMISSION.md にあります。