YouSpot MCP

youspot

YouSpot 的官方 CLI 和 SDK，适用于 AI 原生个人 CRM。

Node 18 或更高版本。无依赖项。

bunx youspot ask "what does it cost"
bunx youspot docs oauth pkce
bunx youspot read /docs/mcp
bunx youspot tools

注册或登录一次，然后就可以在终端中与自己的账户聊天：

bunx youspot signup
bunx youspot chat "who do I know at Acme?"

账户命令和 youspot call 需要会话。其他所有命令都只读取已公开的页面。

命令

命令	功能	凭据
youspot signup	创建账户：输入邮箱、密码和通过邮件发送的验证码。保存会话。	无
youspot login	使用一次性验证码通过浏览器登录。保存会话。	无
youspot whoami	查询此终端登录的账户，并通过服务端验证。	会话
youspot logout	在服务端结束会话，然后在本地删除会话。	会话
youspot chat [message]	与自己的账户聊天。支持一条消息、交互式提示符（you> ），或从 stdin 每行输入一轮对话。	会话
youspot ask <question>	提问有关 YouSpot 的问题。答案来自其页面中的原文片段，每段都附有来源 URL。	无
youspot docs <query>	通过文档 MCP 服务搜索开发者文档。	无
youspot read <path>	以 Markdown 格式读取单个页面，例如 /docs/mcp 或 /pricing。	无
youspot pages	列出所有可读取的页面。	无
youspot tools	列出产品服务上的 MCP 工具。	无
youspot call <tool> [json]	调用一个 MCP 工具。	YOUSPOT_TOKEN，否则使用会话
youspot member <username>	查看一位公开的成员个人资料。	无
youspot directory	查看公开成员目录中的一页。	无
youspot index	列出所有端点及各端点所需的凭据。	无

--json 会输出原始响应。--limit n 适用于 ask、docs 和 directory。 结果输出到 stdout，消息输出到 stderr。成功时退出码为 0，失败时为 1，使用错误时为 2（按 Ctrl-C 中止登录时为 130）。

登录

youspot login 会显示一个链接和一个类似 ABCD-EFGH 的验证码，在浏览器中打开该链接（使用 --no-browser 或未连接终端时，则只显示链接），然后等待。确认页面上的验证码匹配后批准请求，终端会显示 Signed in as <email>。

youspot signup 会要求输入邮箱、密码（输入两次，且不会显示）并同意服务条款和隐私政策，然后要求输入通过邮件发送的验证码。在验证码提示处输入 resend 可获取新验证码。每项信息都可以通过标志传入，因此即使没有终端也能运行：

youspot signup --email [email protected] --password "$PASSWORD" --code 123456 --accept-terms

YOUSPOT_PASSWORD 可以代替 --password，避免密码出现在 shell 历史记录中。

聊天

youspot chat "what needs my attention today?"
youspot chat                       # a prompt; /new starts over, /exit or Ctrl-D leaves
printf 'first\nsecond\n' | youspot chat   # one turn per line
youspot chat --new "start over"
youspot chat --verbose "find Dana"  # also lists the tools each turn called
youspot chat "@research what changed at Acme this week?"  # hands it to that agent
youspot chat --wait "@research what changed at Acme this week?"  # and waits for the reply

除非使用 --new，否则对话会在多次运行之间持续保留。每轮对话后，剩余积分会输出到 stderr。

凭据

每个 YouSpot 工具都会读取或写入某个人自己的联系人、公司、笔记和文件，因此 凭据始终属于某个人。

youspot login 和 youspot signup 会将可撤销的会话保存到 ${XDG_CONFIG_HOME:-~/.config}/youspot/credentials.json（文件权限为 0600，所在目录权限为 0700）， 并按服务器区分，因此本地和生产环境的会话可以并存。对话历史保存在旁边的 conversations.json 中。youspot logout 会撤销会话并删除这两个文件。

对于 youspot call，你也可以在 youspot.com/user/integrations/mcp 创建一个命名令牌并设置 YOUSPOT_TOKEN，它的优先级高于 已保存的会话；或者按照 auth.md 中的 OAuth 2.1 流程操作。

YOUSPOT_BASE_URL 用于选择服务器，例如，将其设为 http://localhost:3001 以连接本地 技术栈。登录链接也会根据它生成。

测试与评估

无头运行可通过标志和环境变量端到端完成。对于开发服务器，其登录使用 Clerk 开发实例，任何包含 +clerk_test 的地址都是测试地址：Clerk 不会发送电子邮件，并接受固定代码 424242。

export YOUSPOT_BASE_URL=http://localhost:3001
youspot signup --email "[email protected]" --password "$EVAL_PASSWORD" --code 424242 --accept-terms
youspot chat --new --json "what can you do?"
youspot logout

将 XDG_CONFIG_HOME 指向一个临时目录，以便将评估会话与自己的会话分开。

作为库使用

import { ask, tools, callTool, login, signup, chat } from "youspot";

const answer = await ask("how do I connect a client");
const available = await tools();
const summary = await callTool("get_connections_summary", {}, { token });

await signup({ email, password, acceptTerms: true, code: "424242" });
const { reply, conversation_id } = await chat("who do I know at Acme?");

login、signup 和 chat 接受 baseUrl、fetch 和 dir（会话的保存位置）； login 还接受 clock 和 onPending({ url, userCode }) 回调，而 signup 接受字符串形式的 code，或一个在每次尝试时都会调用的函数。

对于在其他位置运行 YouSpot 的用户，YOUSPOT_BASE_URL 可覆盖源站。

安装 Agent 技能

列出官方公开仓库中的技能：

bunx skills add OnStartups/youspot-agent-tools --list

将所需技能安装到当前项目中：

bunx skills add OnStartups/youspot-agent-tools --skill youspot-mcp

CLI 会提示你选择目标 Agent。这些技能由 YouSpot, Inc. 为 youspot.com 编写，并在此公开仓库中统一维护：

技能	用途	来源
youspot-mcp	OAuth 设置、Brain 和 LinkedIn 搜索、关注事项审查、互动记录和后续跟进	SKILL.md
youspot-api	公共 HTTP 读取、批量读取、沙盒、MCP JSON-RPC 和身份验证错误	SKILL.md
youspot-solo-crm-playbook	每日关系审查、会议简报和已确认的后续事项	SKILL.md

在安装命令中，将 youspot-mcp 替换为此表中的其他名称。默认情况下，技能安装在项目本地；添加 --agent <agent-name> 可显式选择 Agent。安装技能会添加说明，不会授予账户访问权限。产品工具调用仍需获得成员的 同意和凭据，并且可能消耗额度。

该网站还提供带内容摘要的技能索引。 skills.sh 上的 youspot-mcp 条目 是另一种发现途径；skills.sh 的分类不能替代对发布者和来源的核查。

此软件包包含的内容

• bin/youspot.mjs、src/cli.mjs、src/index.mjs：CLI 和 SDK。test/ 存放它们的测试（bun test）。
• plugin.json 和 mcp.json：Agent Plugins 1.0.0 清单及其指向的 MCP 服务列表（两个服务均使用可流式传输的 HTTP）。技能会按照规范从 skills/ 中发现。
• AGENTS.md、.cursorrules：面向编码 Agent 的说明。
• skills/：三个 Agent 技能，与 youspot.com/.well-known/agent-skills/ 上提供的内容逐字节相同。

AGENTS.md、.cursorrules 和 skills/ 均为生成文件，而非手动编写。技能正文和索引描述来自源代码 monorepo 中的 frontend/lib/agent/skills.ts。网站会计算每个已提供技能的 sha256，因此请修改源文件，并从 monorepo 根目录运行 bun run sync:agent-tools 重新生成，而不要只修改生成文件。CI 会运行 check:agent-tools，若文件内容不一致则会失败。此检查在前端构建之外运行，因为 .vercelignore 会将 *.md 排除在 Vercel 的构建上下文之外。

发布与 skills.sh 发现

唯一可信来源是私有 monorepo 中的 packages/youspot-agent-tools。其公开镜像为 OnStartups/youspot-agent-tools。三个技能都应放在这个仓库中。无需额外仓库或 npm 发布，Skills CLI 即可从 GitHub 安装这些技能。

发布需手动进行，并与本地修改分开：

1. 将审查通过的源代码修改合并到 monorepo 的 main 分支。从已发布的源代码重新生成文件，运行 bun run sync:agent-tools，然后仅将此软件包的公开内容复制到现有镜像中。不要复制私有 monorepo 文件或内部插件。
2. 审查镜像差异，并在维护者批准后发布。部署对应的网站源代码，使网站提供的技能及其摘要与镜像一致。
3. 镜像更新后，使用 bunx skills add OnStartups/youspot-agent-tools --list 列出其技能，然后使用 bunx skills add OnStartups/youspot-agent-tools --skill youspot-mcp 安装所需技能。
4. 在实际安装后，检查相应的 skills.sh 条目。skills.sh 常见问题说明，条目会通过匿名安装遥测自动显示，无需手动提交到注册表。使用 --list 列出技能不算安装；禁用了遥测的安装不会计入索引。不要通过人为制造安装来影响计数。该目录没有说明保证的索引时间，也没有说明会自动授予官方发布者徽章。

将 youspot CLI/SDK 发布到 npm 是由维护者另行控制的发布流程，涉及软件包版本管理和注册表凭据。这并非通过 GitHub 安装技能或在 skills.sh 上被发现的前提条件。