SDKs & Libraries
TypeScript, Python, React
Official SDKs
| SDK | Package | Install | Status |
|---|---|---|---|
| TypeScript / JavaScript | codivupload | npm install codivupload | ✅ Available |
| MCP Server | codivupload-mcp | npx -y codivupload-mcp | ✅ Available — see /docs/mcp |
| Python | codivupload | pip install codivupload | ✅ Available |
| React Hooks | @codivupload/react | — | Planned |
Roadmap
| SDK | Target |
|---|---|
| React Hooks (@codivupload/react) | Q4 2026 |
Dates are estimates and subject to change. Watch the changelog for announcements.
Which Should I Use?
| Your context | Recommended |
|---|---|
| Node.js / Deno / Bun server | TypeScript SDK — npm install codivupload — typed, auto-retry |
| Python scripts or automation | Python SDK — pip install codivupload — typed, auto-retry |
| React / Next.js frontend | TypeScript SDK via server actions — never call from client directly |
| AI assistant (Claude, Cursor, etc.) | MCP — npx -y codivupload-mcp |
TypeScript SDK Quick Start
npm install codivuploadimport { CodivUpload } from "codivupload";
const client = new CodivUpload({ apiKey: process.env.CODIVUPLOAD_API_KEY });
const post = await client.posts.create({
post_type: "text",
profile_name: "my_brand",
platforms: ["x", "linkedin"],
description: "Automated post via CodivUpload SDK.",
});
console.log("Post ID:", post.post_id);Python SDK Quick Start
pip install codivuploadfrom codivupload import CodivUpload
client = CodivUpload(api_key="cdv_your_api_key")
post = client.posts.create(
post_type="text",
profile_name="my_brand",
platforms=["x", "linkedin"],
description="Automated post via CodivUpload Python SDK.",
)
print("Post ID:", post["post_id"])REST API Quick Start
You can also use the REST API directly without the SDK:
// Post to X using fetch (Node.js 18+ or any runtime with fetch)
const response = await fetch("https://api.codivupload.com/v1/posts", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.CODIVUPLOAD_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
post_type: "text",
profile_name: "my_brand",
platforms: ["x"],
description: "Automated post via CodivUpload API.",
}),
});
const data = await response.json();
console.log("Post ID:", data.post_id);The full interactive API reference is available at api.codivupload.com. See API Examples for more ready-to-use code.