← 返回 Skills 市场
🔌

dopost-api

作者 dopost · GitHub ↗ · v1.1.0 · MIT-0
cross-platform ✓ 安全检测通过
117
总下载
1
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install dopost
功能描述
Use the Dopost REST API to publish, schedule, and manage social media posts programmatically. Use this skill when the user wants to publish to social media,...
使用说明 (SKILL.md)

Dopost API

Dopost is a social media management platform. Its REST API lets you publish and schedule posts, manage media, and inspect connected social accounts.

Base URL: https://dopost.co/api/v1
Auth: All requests require the header x-api-key: \x3Cyour-key>
Full docs: https://dopost.co/docs/api

Setup

Always check for an .env or .env.local file with DOPOST_API_KEY. If not present, ask the user for their key before proceeding.

export DOPOST_API_KEY="dpk_live_..."

Endpoints

Social Accounts

List connected accounts

GET /api/v1/social/accounts
Scope: social:accounts

curl -H "x-api-key: $DOPOST_API_KEY" https://dopost.co/api/v1/social/accounts

Returns { accounts: [{ id, platform, platformUsername, platformUserId }] }.
The id field is the accountId needed for publishing.

Get platform limits

GET /api/v1/social/limits/:platform
Scope: social:limits

Platforms: x, instagram, instagram_direct, facebook, linkedin, linkedin_organization, tiktok, youtube, threads, bluesky, mastodon, pinterest

instagram = connected via Meta Business (Facebook Page linked). instagram_direct = connected directly via Instagram OAuth.
linkedin = personal profile. linkedin_organization = company page.

curl -H "x-api-key: $DOPOST_API_KEY" https://dopost.co/api/v1/social/limits/instagram

Posts

Publish or schedule a post

POST /api/v1/post/publish
Scope: posts:create

{
  "accountId": "\x3CaccountId>",
  "text": "Post content",
  "media": ["https://..."],
  "publishAt": "2025-12-25T12:00:00Z",
  "platformOptions": {}
}
  • At least text or media is required
  • media can be an array of URL strings or objects { url: "..." }
  • Maximum 10 media items per post
  • Omit publishAt (or set to null) to publish immediately
  • Returns 202 with { success, jobId, postId, status }
  • Publishing is asynchronous — poll GET /api/v1/post/:postId to check status
Platform-specific options (platformOptions)

Instagram

Field Values Default
postType "feed" | "story" | "reel" "feed" (auto "carousel" with multiple media)

TikTok

Field Values Default
privacyLevel "PUBLIC_TO_EVERYONE" | "MUTUAL_FOLLOW_FRIENDS" | "FOLLOWER_OF_CREATOR" | "SELF_ONLY" "PUBLIC_TO_EVERYONE"
disableDuet boolean false
disableStitch boolean false
disableComment boolean false

YouTube

Field Values Default
videoType "video" | "short" "video"
title string First 100 chars of text
privacyStatus "public" | "private" | "unlisted" "public"

Pinterest

Field Description
board Board ID (required for Pinterest)

Get a post

GET /api/v1/post/:postId
Scope: posts:read

Returns the full post object including publish status:

{
  "id": "cm3abc123def456",
  "status": "PUBLISHED",
  "platform": "INSTAGRAM",
  "text": "Post content",
  "media": [],
  "postUrl": "https://instagram.com/p/...",
  "account": {
    "id": "cm3xyz789ghi012",
    "platform": "INSTAGRAM",
    "platformUsername": "myaccount"
  },
  "schedule": {
    "scheduledFor": "2026-04-13T09:00:00.000Z",
    "status": "PUBLISHED",
    "publishedAt": "2026-04-13T09:00:05.000Z"
  },
  "jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "source": "api",
  "createdAt": "2026-04-07T10:00:00.000Z",
  "updatedAt": "2026-04-07T10:32:18.000Z"
}

schedule is null for immediate posts. postUrl is null until published.
Use this endpoint to poll status after publishing.

List posts

GET /api/v1/post?status=PENDING&limit=20&cursor=\x3Ccursor>
Scope: posts:read

Status filter values: DRAFT, PENDING, PUBLISHED, FAILED

Reschedule a post

PATCH /api/v1/post/:postId
Scope: posts:reschedule
Body: { "publishAt": "2025-12-31T09:00:00Z" }

Only works on posts with status PENDING. The new date must be in the future.
Returns { id, scheduledFor }.

Delete a post

DELETE /api/v1/post/delete/:postId
Scope: posts:delete

Cancels scheduling automatically if the post is PENDING.
Returns { success: true, deletedPostId: "..." }.

Media

Upload media (presigned URL flow)

POST /api/v1/media
Scope: media:upload
Body: { "fileName": "photo.jpg", "contentType": "image/jpeg", "sizeInBytes": 204800 }

Returns 201 with:

{
  "id": "cm3media001xyz",
  "uploadUrl": "https://storage.example.com/...?X-Amz-Signature=...",
  "publicUrl": "https://cdn.dopost.co/media/.../photo.jpg",
  "fileName": "photo.jpg",
  "contentType": "image/jpeg",
  "expiresIn": 3600
}
  • uploadUrl is a temporary presigned URL — upload the file with a PUT request within expiresIn seconds
  • publicUrl is the permanent URL — use this as the media URL when publishing
  • Maximum file size: 1 GB
curl -X PUT -H "Content-Type: image/jpeg" --data-binary @photo.jpg "$UPLOAD_URL"

List media

GET /api/v1/media?limit=20&cursor=\x3Ccursor>
Scope: media:list

Delete media

DELETE /api/v1/media/:mediaId
Scope: media:delete

Returns { message: "Media deleted", mediaId: "..." }.

Common workflows

Publish a post now

  1. GET /api/v1/social/accounts — pick accountId
  2. POST /api/v1/post/publish with accountId + text
  3. GET /api/v1/post/:postId — poll until status is PUBLISHED or FAILED

Publish a post with an image

  1. POST /api/v1/media — get uploadUrl + publicUrl
  2. PUT the file to uploadUrl
  3. POST /api/v1/post/publish with media: [publicUrl]
  4. GET /api/v1/post/:postId — poll until published

Schedule and reschedule

  1. Publish with a future publishAt
  2. To change the date: PATCH /api/v1/post/:postId with new publishAt
  3. To cancel: DELETE /api/v1/post/delete/:postId

Error handling

Status Meaning
400 Bad request — check the request body
401 Invalid or missing x-api-key
403 API key lacks the required scope
404 Resource not found or inactive account
429 Rate limit or monthly quota exceeded. Check X-RateLimit-* headers

On 429, respect the Retry-After header before retrying.

Examples

1. List connected accounts

Request

curl -H "x-api-key: $DOPOST_API_KEY" \
  https://dopost.co/api/v1/social/accounts

Response 200 OK

{
  "accounts": [
    {
      "id": "cm3xyz789ghi012",
      "platform": "INSTAGRAM",
      "platformUsername": "myaccount",
      "platformUserId": "17841400000000001"
    },
    {
      "id": "cm3abc456def789",
      "platform": "LINKEDIN",
      "platformUsername": "johndoe",
      "platformUserId": "urn:li:person:a1B2c3D4e5"
    }
  ]
}

2. Publish a text post immediately

Request

curl -X POST \
  -H "x-api-key: $DOPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "cm3xyz789ghi012",
    "text": "Hello from the Dopost API!"
  }' \
  https://dopost.co/api/v1/post/publish

Response 202 Accepted

{
  "success": true,
  "jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "postId": "cm3abc123def456",
  "status": "processing"
}

3. Check post status

Request

curl -H "x-api-key: $DOPOST_API_KEY" \
  https://dopost.co/api/v1/post/cm3abc123def456

Response — published

{
  "id": "cm3abc123def456",
  "status": "PUBLISHED",
  "platform": "INSTAGRAM",
  "text": "Hello from the Dopost API!",
  "media": [],
  "postUrl": "https://www.instagram.com/p/ABC123/",
  "account": {
    "id": "cm3xyz789ghi012",
    "platform": "INSTAGRAM",
    "platformUsername": "myaccount"
  },
  "schedule": null,
  "jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "source": "api",
  "createdAt": "2026-04-07T10:00:00.000Z",
  "updatedAt": "2026-04-07T10:32:18.000Z"
}

Response — failed

{
  "id": "cm3abc123def456",
  "status": "FAILED",
  "platform": "INSTAGRAM",
  "text": "Hello from the Dopost API!",
  "media": [],
  "postUrl": null,
  "account": {
    "id": "cm3xyz789ghi012",
    "platform": "INSTAGRAM",
    "platformUsername": "myaccount"
  },
  "schedule": null,
  "jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "source": "api",
  "createdAt": "2026-04-07T10:00:00.000Z",
  "updatedAt": "2026-04-07T10:05:00.000Z"
}

4. Publish an Instagram Reel

Request

curl -X POST \
  -H "x-api-key: $DOPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "cm3xyz789ghi012",
    "text": "New reel! #content",
    "media": ["https://cdn.example.com/video.mp4"],
    "platformOptions": {
      "postType": "reel"
    }
  }' \
  https://dopost.co/api/v1/post/publish

Response 202 Accepted

{
  "success": true,
  "jobId": "a1b2c3d4-0000-4abc-8def-111122223333",
  "postId": "cm3reel001xyz",
  "status": "processing"
}

5. Schedule a post

Request

curl -X POST \
  -H "x-api-key: $DOPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "cm3abc456def789",
    "text": "Scheduled post for next Monday!",
    "publishAt": "2026-04-13T09:00:00Z"
  }' \
  https://dopost.co/api/v1/post/publish

Response 202 Accepted

{
  "success": true,
  "jobId": "b2c3d4e5-1111-4bcd-9ef0-222233334444",
  "postId": "cm3sched001abc",
  "status": "scheduled"
}

6. Upload media and publish with it

Step 1 — Request presigned URL

curl -X POST \
  -H "x-api-key: $DOPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileName": "photo.jpg",
    "contentType": "image/jpeg",
    "sizeInBytes": 204800
  }' \
  https://dopost.co/api/v1/media

Response 201 Created

{
  "id": "cm3media001xyz",
  "uploadUrl": "https://storage.example.com/uploads/photo.jpg?X-Amz-Signature=...",
  "publicUrl": "https://cdn.dopost.co/media/cm3media001xyz/photo.jpg",
  "fileName": "photo.jpg",
  "contentType": "image/jpeg",
  "expiresIn": 3600
}

Step 2 — Upload the file

curl -X PUT \
  -H "Content-Type: image/jpeg" \
  --data-binary @photo.jpg \
  "https://storage.example.com/uploads/photo.jpg?X-Amz-Signature=..."

Returns 200 with empty body on success.

Step 3 — Publish using the public URL

curl -X POST \
  -H "x-api-key: $DOPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountId": "cm3xyz789ghi012",
    "text": "Check out this photo!",
    "media": ["https://cdn.dopost.co/media/cm3media001xyz/photo.jpg"]
  }' \
  https://dopost.co/api/v1/post/publish

7. Reschedule a pending post

Request

curl -X PATCH \
  -H "x-api-key: $DOPOST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "publishAt": "2026-04-20T14:00:00Z" }' \
  https://dopost.co/api/v1/post/cm3sched001abc

Response 200 OK

{
  "id": "cm3sched001abc",
  "scheduledFor": "2026-04-20T14:00:00.000Z"
}

8. List posts with filter

Request

curl -H "x-api-key: $DOPOST_API_KEY" \
  "https://dopost.co/api/v1/post?status=PUBLISHED&limit=5"

Response 200 OK

{
  "posts": [
    {
      "id": "cm3abc123def456",
      "status": "PUBLISHED",
      "text": "Hello from the Dopost API!",
      "publishedAt": "2026-04-07T10:32:18.000Z",
      "account": {
        "id": "cm3xyz789ghi012",
        "platform": "INSTAGRAM",
        "platformUsername": "myaccount"
      }
    }
  ],
  "nextCursor": null,
  "hasMore": false
}

9. Delete a post

Request

curl -X DELETE \
  -H "x-api-key: $DOPOST_API_KEY" \
  https://dopost.co/api/v1/post/delete/cm3sched001abc

Response 200 OK

{
  "success": true,
  "deletedPostId": "cm3sched001abc"
}

MCP server (optional)

If the user has the Dopost MCP server configured, prefer using MCP tools (publish_post, list_accounts, etc.) over raw HTTP calls — they handle auth and path safety automatically.

MCP setup: https://dopost.co/docs/api

安全使用建议
This skill will use your Dopost API key (DOPOST_API_KEY) to call Dopost endpoints and publish or schedule posts. Only install it if you trust the Dopost integration and the skill source. Prefer creating a scoped API key with minimal permissions rather than a full account master key, and rotate or revoke the key if you stop using the skill. Confirm the API key is stored securely (not committed to public repos) and review Dopost's official docs (https://dopost.co/docs/api) if you need to verify endpoint behavior. Note: the skill can be invoked by an agent per platform defaults — ensure you are comfortable with the agent performing publishing actions on your behalf.
功能分析
Type: OpenClaw Skill Name: dopost Version: 1.1.0 The skill bundle provides standard documentation and instructions for interacting with the Dopost REST API for social media management. It includes clear API endpoint definitions, authentication requirements via environment variables, and typical curl examples for publishing and managing posts without any signs of malicious intent or data exfiltration (SKILL.md).
能力标签
requires-oauth-token
能力评估
✓ Purpose & Capability
Name/description, documented endpoints, and required DOPOST_API_KEY align. All declared capabilities (publish, schedule, media upload, account listing) map directly to the API endpoints documented in SKILL.md.
✓ Instruction Scope
SKILL.md limits runtime actions to preparing HTTP requests to dopost.co endpoints and instructs checking for a DOPOST_API_KEY in .env or asking the user. It does not ask to read unrelated files, access other credentials, or send data to unexpected endpoints.
✓ Install Mechanism
Instruction-only skill with no install spec and no code files — nothing is written to disk or downloaded. This is the lowest-risk install model and fits the skill's purpose.
✓ Credentials
Only a single env var (DOPOST_API_KEY) is required and is appropriate for the documented REST API usage. The SKILL.md references only that key for authentication; no unrelated secrets or system paths are requested.
✓ Persistence & Privilege
The skill is not always-enabled (always: false) and does not request persistent system-wide configuration. It uses the platform-default autonomous invocation capability, which is standard for skills and not excessive here.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install dopost
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /dopost 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.1.0
dopost-api v1.1.0 - Adds detailed SKILL.md documentation covering all major Dopost REST API endpoints, authentication, required environment variables, and usage workflows. - Includes endpoint references for social account management, publishing, scheduling, media upload, and error handling. - Specifies when to activate the skill, including explicit user intents and keyword triggers. - Outlines setup instructions and platform-specific options for publishing and scheduling posts. - Provides example requests and responses for common use cases.
元数据
Slug dopost
版本 1.1.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

dopost-api 是什么？

Use the Dopost REST API to publish, schedule, and manage social media posts programmatically. Use this skill when the user wants to publish to social media,... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 117 次。

如何安装 dopost-api？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install dopost」即可一键安装，无需额外配置。

dopost-api 是免费的吗？

是的，dopost-api 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

dopost-api 支持哪些平台？

dopost-api 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 dopost-api？

由 dopost（@dopost）开发并维护，当前版本 v1.1.0。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191113 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 留言讨论