用途:把 TVmaze(tvmaze.com)的搜索能力接入智能体。该服务由第三方 Unbrowse 汇编,属非官方项目,未获 tvmaze.com 授权或认可;调用在服务端重放 TVmaze 自己的第一方 API,返回已验证结果,不抓取渲染页面,用户侧无浏览器,也不需要 TVmaze API 密钥。
主要能力:该 MCP 服务器是仅限 tvmaze.com 的工具作用域,包含已编译工具及运行它们的 Unbrowse 工具。核心工具 tvmaze_com__get_search 用于搜索 TVmaze:输入 query(字符串,必填),返回页面标题、可读文本和链接;支持 select 参数裁剪结果(如 "results[].{title,url}")。此外提供 unbrowse.run(用自然语言在 tvmaze.com 上执行任务)、inspect、resume、scrape、map,以及云浏览器 unbrowse.browse.open → act → finish。
使用方式:通过 MCP 连接,例如 claude mcp add --transport http tvmaze https://unbrowse.ai/mcp/tvmaze.com,或 codex mcp add tvmaze --url https://unbrowse.ai/mcp/tvmaze.com && codex mcp login tvmaze。首次连接以 OAuth 登录 Unbrowse(免费层,仅验证结果计数);脚本方式可发 Authorization: Bearer $UNBROWSE_API_KEY,密钥来自 https://unbrowse.ai/app/keys,应存入密钥管理器。也可直接 REST 调用:curl -s https://unbrowse.ai/api/v1/sites/tvmaze.com/call/tvmaze_com__get_search -H "authorization: Bearer $UNBROWSE_API_KEY" -H "content-type: application/json" -d '{"query":"<query>"}'。
结果处理与限制:succeeded 表示返回已验证结果;input_required 需通过 unbrowse.resume {runId, answers} 补充字段。无匹配工具时用 unbrowse.run {task},无能力时报 no_capability,可先用云浏览器跑一次以编译新工具。范围外请求返回 not_in_scope,需改用通用 Unbrowse 服务器。切勿向用户索要密码,可用 autofill 从 Unbrowse 密码管理器填充登录。发布、购买、发送或删除需用户确认;outcome_unknown 表示可能已变更,需核实后再重试。若会话工具列表中没有上述工具,说明未连接或未登录,应停止,不得改用其他方式抓取 tvmaze.com 冒充本技能结果。