actually

Actually - 市场究竟怎么看

一个 Chrome 扩展和 MCP 服务，可将预测市场的赔率显示在你正在阅读的新闻上。

新闻会告诉你“专家对此表示担忧”或“赔率正在上升”，却很少告诉你具体数字。这个数字就在预测市场上，人们用自己的钱押注结果。只是它藏在另一个标签页里，而找到它，首先得知道这个市场存在。

Actually 填补了这一空白。打开一篇文章，点击工具栏图标，扩展就会将文本与 Polymarket 实时市场进行匹配，并显示市场给出的概率。无需账户、钱包或注册。

从 Chrome 网上应用店添加到 Chrome - 免费。

功能

• 将文章与市场匹配。 本地嵌入模型 （Xenova/all-MiniLM-L12-v2，约 33 MB）会根据缓存的市场集合为文章文本打分，并结合关键词和数字重合度进行加权——数字很重要，因为编码器几乎无法识别数字，而“跌至 $57,500”和“涨至 $120,000”的嵌入结果几乎完全相同。

• 在你的设备上运行。 模型和 WASM 运行时在构建时打包——安装或运行时不会从 CDN 获取任何内容；使用默认设置时，文章文本不会离开设备。

• 读取非英语页面。 匹配前会通过 Chrome 内置的 Translator API（本地运行，无需联网）将页面翻译成英语。Polymarket 的每个问题都用英语编写，而本地模型在 30522 个词元中只有 86 个西里尔字母词元——未经翻译的俄语标题会被嵌入成噪声。翻译后，同一标题与其实际相关的市场的匹配得分为 0.53–0.71，高于 0.35 的最低值。

  

• 可选交易。 连接任意 WalletConnect v2 钱包，即可进行限价单和市价单交易、卖出、取消挂单，并通过持仓面板查看成本基础和盈亏。我们绝不会持有你的密钥或资金。

• 也为 Agent 提供服务。 同样的功能也通过 Model Context Protocol 提供：check_news、get_market、place_order、sell_order、cancel_order、get_positions。

使用 MCP 服务

MCP 服务已发布，无需克隆或构建。将其添加到任意 MCP 客户端（Claude Desktop、Cursor，以及任何支持该 协议的客户端）：

{
  "mcpServers": {
    "actually": {
      "command": "npx",
      "args": ["actually-mcp-server"]
    }
  }
}

这样 Agent 就能使用信号工具——check_news 和 get_market——无需 密钥，也无需钱包。给它一条新闻标题，问“市场对此怎么看？”，它 就会用市场自身的价格作答。

首次启动时会下载软件包及其本地模型运行时（约 170 MB），随后首次调用 check_news 时会下载 34 MB 的模型。在网速较慢时，这可能比客户端等待服务启动的时间更长；如果 客户端报告超时，请在终端中运行一次 npx -y actually-mcp-server， 等待其完成，然后重启客户端。之后的启动只需几秒钟。

只有提供自己的密钥时，交易工具才会出现：

"env": {
  "POLYMARKET_PRIVATE_KEY": "0x...",
  "ACTUALLY_MAX_ORDER_USD": "100",
  "ACTUALLY_DAILY_LIMIT_USD": "500"
}

两项上限都会在服务端根据持久化的支出记录强制执行，因此 Agent 无法通过声称价格不同来绕过限制。 redeem_position 还需要明确选择启用 （ACTUALLY_ENABLE_REDEEM=true），因为它会提交真实的链上交易， 且仍在测试中。

完整文档（包括所有环境变量以及这些保护措施背后的原因）：packages/mcp-server/README.md。

已列入官方 MCP 注册表， 名称为 io.github.Sofiia7/actually，也已列入 mcpservers.org 和 Glama：

各部分如何协同工作

extension/            Chrome MV3 extension (React popup, offscreen document)
extension/worker/     Cloudflare Worker - API proxy, rate limiting, market cache
packages/core/        Matching, pricing and Polymarket API logic, shared by both clients
packages/mcp-server/  MCP server, published to npm as actually-mcp-server
packages/market-cache-builder/   Cron job that precomputes the market embeddings

繁重的工作由屏幕外文档负责，因为 MV3 服务工作线程无法运行 WASM、保持 WebSocket 连接，也无法存活足够长的时间来签署订单。

市场缓存包含 2000 个开放市场及其预先计算的嵌入向量，每两小时重建一次。市场筛选综合了三种排序方式——24 小时交易量、总交易量和近期程度——因为仅按总交易量排序并不适合新闻工具：今天早上在今日头条之下开设的市场没有历史数据，每次都会输给一年前的选举市场。

设置 Worker 是为了让客户端无需持有凭证。它代理 Polymarket 的 API，提供预先计算的缓存，并充当 relayer 的远程签名者，因此 builder 凭证留在服务端，不会随扩展一起分发。

运行方式

npm install
npm run models:fetch -w extension   # bundle the embedding model
npm run build -w extension          # type-check + build to extension/dist

在 Chrome 中将 extension/dist 作为未打包扩展加载。先将 extension/.env.example 复制为 .env.local 并填写内容——构建过程会将 Worker URL、WalletConnect 项目 ID 和 builder 代码打包进去。

npm test --workspaces               # 822 tests across four workspaces

隐私

发现功能免费且无需账户。没有内容脚本：只有在你点击后才会读取页面，而且仅限当前活动标签页。使用默认设置（本地嵌入向量）时，文章文本不会离开你的设备——如果页面需要翻译，翻译也会通过浏览器内置的翻译器在本地运行，无论使用哪种嵌入向量提供方。遥测为可选功能，默认关闭。

完整政策：https://actually-api.sofiaseremeteva.workers.dev/privacy

状态

此扩展已上架 Chrome Web Store。 actually-mcp-server 已发布到 npm，并列入官方 MCP 注册表。

赎回已结算的仓位仍在测试中：builder 身份验证、 负风险合约选择和余额为零保护均已通过实时服务验证，但尚未观察到赎回流程端到端地成功收到资金。

查看赔率在任何地区均可使用。开立新仓位遵循 Polymarket 自身的限制： 在包括美国、英国、法国、德国、意大利、荷兰、比利时、波兰、爱尔兰、澳大利亚、新西兰、日本、 新加坡、台湾、泰国、巴西、俄罗斯，以及加拿大的安大略省、不列颠哥伦比亚省、艾伯塔省和魁北克省在内的地区，无法开立新仓位；在这些地区，仍可卖出现有仓位并取消挂单。受制裁的司法管辖区会被完全屏蔽。此项检查在 Worker 上运行。

Actually 不提供财务建议。

Polymarket 工具目录

• PolyMart：Polymarket 工具目录。

许可证

请参阅 LICENSE。