Community研究与数据分析github.com

BigValue Real Estate 设置

用于 BigValue 数据市场工作区的 Agent 技能,指导用户配置 MCP 连接并完成 OAuth 登录。

BigValue Real Estate 设置 是什么?

该技能专为 BigValue 数据市场工作区设计,主要任务是通过检测客户端环境(如 Claude Code、Codex、Claude Desktop),检查 MCP 插件 `bigvalue-realestate` 的安装与连接状态,并指导用户完成 OAuth 浏览器登录。技能本身不执行登录命令或修改配置文件,只提供状态判断和操作指引,确保用户亲自完成浏览器交互以提高稳定性。支持 Claude Code(自动注册 MCP 服务器)、Codex(需手动配置 config.toml)和 Claude Desktop(自定义连接器)三种平台。登录后通过调用代表性工具验证连接,并强调不在输出中泄露授权码或令牌,维护高安全标准。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add BigValue-Agent/data-marketplace-agent-skills

Installed? Explore more 研究与数据分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

BigValue Real Estate 设置 是做什么的?

插件安装后,先检查 MCP 连接状态;如果尚未登录,则根据客户端指导相应的登录方法。

认证方式不是 API 密钥输入,而是浏览器 Google 登录(OAuth)。安装时无需输入任何值,首次使用时登录一次即可连接。令牌的保存和刷新由客户端自行处理。

此技能仅检查状态并给予指导。不会代执行登录命令——浏览器往返需要用户在交互式终端中亲自完成,才能稳定结束。也不会直接编辑配置文件或凭据文件。

如果仅通过 npx skills add 安装了技能,则 MCP 连接应遵循入门指南,本技能可跳过。

状态检查

  1. 识别当前客户端。Claude Code 中使用 claude plugin list --json 和 claude mcp list,Codex 中使用 codex plugin list --json 和 codex mcp list --json。如果需要 shell 授权,请先获取。
  2. 检查插件 bigvalue-realestate 是否已安装并处于激活状态。
  3. 检查 MCP 服务器 bigvalue-realestate 的状态。登录前服务器会直接拒绝连接,因此显示为 ! Needs authentication,如果显示 ✔ Connected 则表示已登录。为了更加确定,可调用一次代表性工具进行验证。
  4. 如果仅要求检查状态,则以韩文报告判定结果,不进行任何修改。

Claude Code 路径

安装插件后,MCP 服务器会自动注册。剩下的就是一次登录。

无需额外命令——在首次数据查询时,客户端会自动弹出浏览器登录。以下是手动路径。

  1. 如果 claude mcp list 中显示 ! Needs authentication 属于正常情况——表示尚未登录。
  2. 指导用户执行 /mcp 并选择 bigvalue-realestate。浏览器会打开,完成 Google 登录和授权后连接即完成。
  3. 替代方案:在外部交互式终端中直接运行 claude mcp login plugin:bigvalue-realestate:bigvalue-realestate 也可。此技能不会代执行此命令。
  4. 首次登录后,请在新会话中进行验证。登录前已在运行的进程可能无法读取新的认证状态。
  5. 如果登录的帐户不在允许列表中,会显示“无法连接的帐户”页面。此时请指导用户联系入门负责人申请帐户许可。

要在 Claude Desktop 的聊天中使用,请引导用户使用自定义连接器而非插件——在 Settings → Connectors → Add custom connector 中输入 https://datamarket-mcp.bigvalue.ai/mcp 并点击 Connect,即可看到相同的 Google 登录页面。

Codex 路径

Codex 插件仅包含技能。MCP 需要单独注册并登录。

  1. 指导用户在 ~/.codex/config.toml 中添加服务器。由于默认认证方式即为 OAuth,无需额外指定。

    [mcp_servers.bigvalue-realestate]
    url = "https://datamarket-mcp.bigvalue.ai/mcp"
    
  2. 让用户在外部交互式终端中执行登录。此技能也不会代执行此命令。

    codex mcp login bigvalue-realestate
    
  3. 将 Codex 作为新进程重新启动。设置和登录状态不会反映到正在运行的进程中。

  4. 通过 codex mcp list --json 和调用代表性工具来验证连接。

验证

连接成功后,调用一次代表性工具以确认响应(例如小区搜索)。不要输出或记录登录 URL、授权码或令牌。

安全边界

  • 不请求、输出、复制或记录登录 URL、授权码或令牌。浏览器往返由用户自行处理。
  • 对 ~/.codex/config.toml 的修改仅提供上述片段,由用户自行更新。不要直接编辑 Claude 设置、凭据文件或插件缓存。
  • 不要移除或更改用户自行配置的其他 MCP 服务器或无关插件。

相关技能