JavaScript/TypeScript SDK for the SuperMe API — ask experts, search perspectives, manage your knowledge library, and more.
Unofficial community SDK. Built with ❤️ by apedebugger.
Built on top of the official SuperMe Python SDK by the SuperMe team. This package brings the same API to JavaScript/TypeScript ecosystems.
Personal website bot Add a SuperMe-powered chat to your portfolio or CV site that answers visitor questions as you — using your own expert profile and knowledge base. Inspired by projects like cv-santiago.
OpenClaw bots Connect SuperMe as a knowledge and identity layer inside OpenClaw bots — letting your agent answer questions, fetch expert perspectives, and maintain conversation memory across sessions.
WhatsApp / Telegram agents Build personal AI assistants on messaging platforms that respond with expert knowledge from SuperMe, support multi-turn conversations, and let users query any expert on the network.
Second brain API Use SuperMe as a knowledge backend — add articles, notes, and URLs to your library and query them through any app or agent you build.
Multi-expert group chats
Simulate conversations between multiple SuperMe experts on any topic using groupConverse — useful for research, learning, and content creation.
npm install superme-js
# or
pnpm add superme-js
# or
yarn add superme-jsGet your API key at superme.ai/settings → API Keys.
# .env or .env.local
SUPERME_API_KEY=your_api_key_hereimport { SuperMeClient } from "superme-js";
const client = new SuperMeClient({
apiKey: process.env.SUPERME_API_KEY!,
});
// Ask an expert a question
const answer = await client.conversations.ask(
"What are the key principles of growth marketing?",
"ludo"
);
console.log(answer);
// Get your own profile
const profile = await client.profiles.get();
console.log(profile.name, profile.title);
// Get expert perspectives on a topic
const perspectives = await client.profiles.perspectiveSearch(
"How should founders think about pricing?"
);| Option | Type | Default | Description |
|---|---|---|---|
apiKey |
string |
— | Required. Your SuperMe API key |
mcpBaseUrl |
string |
https://mcp.superme.ai |
MCP server URL |
restBaseUrl |
string |
https://www.superme.ai |
REST base URL |
timeout |
number |
120000 |
Request timeout in ms |
Ask a question to a specific user's SuperMe agent.
const answer = await client.conversations.ask(
"What is product-market fit?",
"ludo",
{ conversationId: "abc123" } // optional, for multi-turn
);Talk to your own SuperMe AI agent.
const { response, conversation_id } = await client.conversations.askMyAgent(
"Summarise my recent conversations"
);
// Continue the thread
const followUp = await client.conversations.askMyAgent(
"Tell me more about the first one",
{ conversationId: conversation_id ?? undefined }
);Stream your own agent's response.
for await (const chunk of client.conversations.askMyAgentStream("Tell me something")) {
if (chunk._done) {
console.log("Done. conversation_id:", chunk.conversation_id);
} else {
process.stdout.write(chunk.chunk ?? "");
}
}List your most recent conversations.
Fetch a single conversation with all its messages.
Start or continue a multi-turn group conversation between multiple users.
const result = await client.conversations.groupConverse(
["ludo", "shubhammittal"],
"How should PMs think about AI adoption?",
{ maxTurns: 3 }
);Stream a group conversation. Yields per-perspective chunks.
Get a user's public profile. Omit identifier for your own profile.
Search for users by name.
Resolve multiple names to SuperMe users in one call.
Get perspectives from multiple experts on a topic.
Save notes or knowledge to your personal library.
Update an existing note.
Submit URLs to be crawled and added to your knowledge base.
Check which URLs are not yet in your knowledge base.
List connected social accounts and blogs.
Connect a social platform. Supported: medium, substack, x, instagram, youtube, beehiiv, google_drive, linkedin, github, notion.
Disconnect a social platform.
Connect or disconnect a custom blog.
List active job roles.
Start a background agent interview. Returns immediately with status "preparing".
Stream interview events via async generator.
List your interviews.
Poll interview status.
Get the full transcript for a completed interview.
Drop-in replacement for openai.chat.completions.create:
const completion = await client.chat.completions.create({
model: "superme-agent",
messages: [{ role: "user", content: "What is PLG?" }],
username: "ludo", // omit to use your own agent
});
console.log(completion.choices[0].message.content);
console.log(completion.metadata.conversation_id);// List all available MCP tools
const tools = await client.mcpListTools();
// Call any tool directly
const result = await client.mcpToolCall("get_profile", { identifier: "ludo" });
// Raw JSON-RPC
const raw = await client.rawRequest("tools/list");import { SuperMeError, SuperMeAuthError, SuperMeTimeoutError } from "superme-js";
try {
const profile = await client.profiles.get("someone");
} catch (err) {
if (err instanceof SuperMeAuthError) {
console.error("Check your API key.");
} else if (err instanceof SuperMeTimeoutError) {
console.error("Request timed out.");
} else if (err instanceof SuperMeError) {
console.error("SuperMe error:", err.message, err.code);
}
}// lib/superme.ts
import { SuperMeClient } from "superme-js";
export const superme = new SuperMeClient({
apiKey: process.env.SUPERME_API_KEY!,
});// app/api/ask/route.ts
import { superme } from "@/lib/superme";
import { NextRequest, NextResponse } from "next/server";
export async function POST(req: NextRequest) {
const { question, username } = await req.json();
const answer = await superme.conversations.ask(question, username);
return NextResponse.json({ answer });
}- Node.js 18+ (uses native
fetch) - Works in any modern runtime: Next.js, Remix, Bun, Deno, Cloudflare Workers
MIT © apedebugger