io.github.ndesv21/socialclaw
NPM · SOCIALCLAW · 2 COMPONENTS · SCANNED AUG 3
Connect any AI agent to 11+ social platforms: schedule, publish & track posts via hosted MCP.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security100
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- No production dependencies, so there is no dependency health to assess. View diagnostics → Pass
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 6 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability75
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 1392 tokens (~77/item across 18 items; 18 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage90
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 71% of tool parameters carry a description.Partial
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · socialclaw
claude mcp add ndesv21-socialclaw -- npx -y socialclaw
codex mcp add ndesv21-socialclaw -- npx -y socialclaw
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"ndesv21-socialclaw": {
"type": "local",
"command": [
"npx",
"-y",
"socialclaw"
],
"enabled": true
}
}
} openclaw mcp add ndesv21-socialclaw --command npx --arg -y --arg socialclaw
mcp_servers:
ndesv21-socialclaw:
command: "npx"
args: ["-y", "socialclaw"] {
"mcpServers": {
"ndesv21-socialclaw": {
"command": "npx",
"args": [
"-y",
"socialclaw"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 2 Aug 26 +15
- Malware scan: unverified → pass ▲ security
- 31 Jul 26 −20
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 28 Jul 26 +26
- Source repository: pass → fail ▼ security
- Security disclosure: fail → unverified ▼ functional
- Tool coverage: unverified → 100 ▲ functional
- First check of Tool coverage: 71 functional
- First check of Schema quality: pass functional
- First check of Schema quality: good functional
- First check of Schema quality: fail functional
- 27 Jul 26 0
- Package version: 0.1.16 → 0.1.18 functional
- 26 Jul 26 47
First indexed and scored.
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed npm/[email protected]
Provenance none
Ecosystem: npm · Outcome: none
Dependencies 0 packages
0 packages in the resolved dependency tree.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
account_capabilities Account capabilities ~72
Get publish capabilities and provider rules for connected accounts: what media is allowed, text limits, and whether publishing is currently possible. Pass accountId for one account, or provider to filter, or neither for all.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | — | Optional account id. |
| provider | string | — | Optional provider filter. |
No output schema declared.
No examples provided.
apply_schedule Apply schedule ~164
Create a publishing run from a schedule document. Posts are scheduled or published through connected accounts. Send an idempotencyKey so retries do not create duplicate runs; one is generated when omitted.
| Name | Type | Req | Description |
|---|---|---|---|
| idempotencyKey | string | — | Stable key to deduplicate retries. |
| schedule | object | yes | SocialClaw schedule document. Minimal shape: { timezone, posts: [{ account, name, description, publish_at, media_link? }] }. Campaign documents use { timezone, campaigns: [...] }. Per-post provider s… |
No output schema declared.
No examples provided.
cancel_post Cancel post ~24
Cancel a scheduled post before it publishes.
| Name | Type | Req | Description |
|---|---|---|---|
| postId | string | yes | — |
No output schema declared.
No examples provided.
connect_account Connect account ~104
Start connecting a new social account. For OAuth providers this returns an authorizeUrl the user must open in a browser. Telegram requires botToken and chatId; Discord requires webhookUrl.
| Name | Type | Req | Description |
|---|---|---|---|
| botToken | string | — | Telegram bot token (telegram only). |
| chatId | string | — | Telegram chat target, e.g. @yourchannel (telegram only). |
| provider | string | yes | Provider to connect. |
| webhookUrl | string | — | Discord channel webhook URL (discord only). |
No output schema declared.
No examples provided.
get_analytics Get analytics ~70
Get analytics snapshots for a post, an account, or a run. scope must be post, account, or run; id is the matching identifier.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | — |
| scope | string | yes | — |
| window | string | — | Optional analytics window, e.g. 7d. |
No output schema declared.
No examples provided.
get_post Get post ~27
Get one post including its delivery state and provider identifiers.
| Name | Type | Req | Description |
|---|---|---|---|
| postId | string | yes | — |
No output schema declared.
No examples provided.
list_accounts List accounts ~64
List connected social accounts in the SocialClaw workspace. Optionally filter by provider (x, facebook, instagram_business, instagram, linkedin, linkedin_page, pinterest, tiktok, telegram, discord, youtube, reddit, wordpress).
| Name | Type | Req | Description |
|---|---|---|---|
| provider | string | — | Optional provider filter. |
No output schema declared.
No examples provided.
list_assets List assets ~178
List media (images/videos) the user has uploaded to their SocialClaw library, newest first. Each asset includes a publicUrl usable directly as media_link in validate_schedule/apply_schedule. Use this to find a previously uploaded file (e.g. from the dashboard) to post. Optionally filter by kind (image/video), mime, or a text query over filename/id.
| Name | Type | Req | Description |
|---|---|---|---|
| kind | string | — | Filter by media kind: image or video. |
| limit | number | — | Maximum assets to return. Defaults to 24, capped at 48. |
| mime | string | — | Optional mime prefix filter, e.g. video/mp4. |
| query | string | — | Optional text match over filename, id, kind, mime, or url. |
| sort | string | — | created_desc (default, newest first) or created_asc. |
No output schema declared.
No examples provided.
list_posts List posts ~101
List posts in the workspace with optional filters.
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | — | Account handle filter. |
| campaignId | string | — | — |
| limit | number | — | Maximum posts to return. Defaults to 20 and is capped at 50. |
| offset | number | — | Offset for paging through results. |
| provider | string | — | — |
| runId | string | — | — |
| status | string | — | e.g. scheduled, published, failed, canceled. |
No output schema declared.
No examples provided.
post_attempts Post attempts ~35
List publish attempts for a post, including provider errors. Use this to debug failed posts.
| Name | Type | Req | Description |
|---|---|---|---|
| postId | string | yes | — |
No output schema declared.
No examples provided.
preview_campaign Preview campaign ~126
Preview how a campaign schedule document expands into concrete posts and steps without creating anything.
| Name | Type | Req | Description |
|---|---|---|---|
| schedule | object | yes | SocialClaw schedule document. Minimal shape: { timezone, posts: [{ account, name, description, publish_at, media_link? }] }. Campaign documents use { timezone, campaigns: [...] }. Per-post provider s… |
No output schema declared.
No examples provided.
publish_draft Publish draft ~54
Publish a previously created draft run, optionally at a given ISO-8601 start time.
| Name | Type | Req | Description |
|---|---|---|---|
| runId | string | yes | Draft run id. |
| startAt | string | — | Optional ISO-8601 publish start time. |
No output schema declared.
No examples provided.
retry_post Retry post ~21
Retry a failed post.
| Name | Type | Req | Description |
|---|---|---|---|
| postId | string | yes | — |
No output schema declared.
No examples provided.
run_status Run status ~28
Get the status summary of a publishing run and its posts.
| Name | Type | Req | Description |
|---|---|---|---|
| runId | string | yes | — |
No output schema declared.
No examples provided.
upload_asset Upload asset ~59
Upload a local media file (image or video) to SocialClaw hosted storage. Returns an asset id and a public URL that can be used as media_link in schedules.
| Name | Type | Req | Description |
|---|---|---|---|
| filePath | string | yes | Absolute or relative path to the media file. |
No output schema declared.
No examples provided.
validate_schedule Validate schedule ~139
Validate a schedule document against provider rules, media limits, account state, and publish times WITHOUT creating any posts. Always run this before apply_schedule.
| Name | Type | Req | Description |
|---|---|---|---|
| schedule | object | yes | SocialClaw schedule document. Minimal shape: { timezone, posts: [{ account, name, description, publish_at, media_link? }] }. Campaign documents use { timezone, campaigns: [...] }. Per-post provider s… |
No output schema declared.
No examples provided.
workspace_health Workspace health ~41
Get workspace health, including connection state across providers. Pass provider to check one provider's connections.
| Name | Type | Req | Description |
|---|---|---|---|
| provider | string | — | Optional provider to check connection health for. |
No output schema declared.
No examples provided.
workspace_usage Workspace usage ~17
Get workspace usage counters and plan entitlement consumption.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.