YouSpot MCP

youspot

YouSpot の公式 CLI および SDK です。YouSpot は 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]	アカウントとチャットします。メッセージを 1 件送信するか、プロンプト（you> ）を使うか、標準入力から 1 行ずつターンを送信します。	セッション
youspot ask <question>	YouSpot について質問します。回答には YouSpot のページから抜き出した文章と、その出典 URL が含まれます。	なし
youspot docs <query>	ドキュメント MCP サーバーを通じて開発者向けドキュメントを検索します。	なし
youspot read <path>	1 ページを Markdown として読み取ります。例：/docs/mcp や /pricing。	なし
youspot pages	読み取り可能なすべてのページを表示します。	なし
youspot tools	製品サーバー上の MCP ツールを一覧表示します。	なし
youspot call <tool> [json]	MCP ツールを 1 つ呼び出します。	YOUSPOT_TOKEN、それ以外はセッション
youspot member <username>	公開メンバープロフィールを 1 件表示します。	なし
youspot directory	公開メンバーディレクトリの 1 ページを表示します。	なし
youspot index	すべてのエンドポイントと、それぞれに必要な認証情報を表示します。	なし

--json は生のレスポンスを出力します。--limit n は ask、docs、directory に適用されます。 結果は標準出力に、メッセージは標準エラー出力に出力されます。成功時の終了コードは 0、失敗時は 1、使い方に誤りがある場合は 2 です（Ctrl-C でサインインを中断した場合は 130）。

サインイン

youspot login はリンクと ABCD-EFGH のようなコードを表示し、ブラウザーでリンクを開きます（--no-browser を指定した場合、またはターミナルがない場合はリンクだけを表示します）。その後、処理を待機します。ページでコードが一致していることを確認してリクエストを承認すると、ターミナルに Signed in as <email> と表示されます。

youspot signup はメールアドレス、パスワード（2 回入力。入力内容は表示されません）、利用規約とプライバシーポリシーへの同意を求めた後、メールで届くコードを求めます。コードの入力時に resend と入力すると、新しいコードを受け取れます。すべての回答はフラグで指定することもできるため、ターミナルがなくても実行できます。

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

YOUSPOT_PASSWORD は --password の代わりに使用できます。これにより、パスワードがシェルの履歴に残りません。

チャット

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 を指定するまで、実行をまたいで続きます。各ターンの後、残りのクレジットが標準エラー出力に表示されます。

認証情報

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 でオリジンを上書きできます。

エージェントスキルをインストールする

公式の公開リポジトリにあるスキルを一覧表示します。

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

現在のプロジェクトに必要なスキルだけをインストールします。

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

CLI が対象のエージェントを尋ねます。これらのスキルは、youspot.com 向けに YouSpot, Inc. が作成し、この公開リポジトリでまとめて管理しています。

スキル	用途	ソース
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> を追加します。スキルをインストールしても追加されるのは指示だけで、アカウントへのアクセス権は付与されません。製品のツール呼び出しには、引き続きメンバーの同意と認証情報が必要で、クレジットを消費する場合があります。

サイトでは、コンテンツダイジェストを含むスキルインデックスも公開しています。 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：コーディングエージェント向けの指示です。
• skills/：3 つのエージェントスキルです。youspot.com/.well-known/agent-skills/ で提供されているものとバイト単位で同一です。

AGENTS.md、.cursorrules、skills/ は手書きではなく、生成されたファイルです。スキル本文とインデックスの説明は、ソースモノレポの frontend/lib/agent/skills.ts に由来します。サイトは提供する各スキルの sha256 を計算するため、生成ファイルだけを編集するのではなく、ソースを編集し、モノレポのルートから bun run sync:agent-tools を実行して再生成してください。CI では check:agent-tools が実行され、差分があると失敗します。このチェックはフロントエンドのビルドとは別に実行されます。これは .vercelignore によって Vercel のビルドコンテキストから *.md が除外されるためです。

skills.sh への公開と検出

信頼できる唯一の情報源は、非公開モノレポにある packages/youspot-agent-tools です。公開ミラーは OnStartups/youspot-agent-tools です。3 つのスキルはすべて、この 1 つのリポジトリに置きます。Skills CLI で GitHub からインストールするために、別のリポジトリや npm リリースは必要ありません。

公開は手動で行い、ローカルでの編集とは別の作業です。

1. レビュー済みのソース変更をモノレポの main ブランチにマージします。公開済みのソースから bun run sync:agent-tools で再生成し、このパッケージの公開対象の内容のみを既存のミラーにコピーします。非公開のモノレポのファイルや内部プラグインはコピーしないでください。
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 の FAQ によると、手動でレジストリに申請しなくても、匿名のインストールテレメトリーを通じて掲載が自動的に表示されます。--list による一覧表示はインストールではありません。また、テレメトリーを無効にしたインストールはインデックス登録に反映されません。件数に影響を与えるための人工的なインストールは行わないでください。このディレクトリには、インデックス登録にかかる確定的な時間や、公式パブリッシャーのバッジが自動的に付与されることは記載されていません。

youspot CLI/SDK の npm への公開は、パッケージのバージョン管理とレジストリの認証情報を伴う、メンテナーが別途管理するリリースです。GitHub からのスキルのインストールや skills.sh での検出に先立って行う必要はありません。