← Back to Skills Marketplace
justoneapi

Social Media API

by justoneapi · GitHub ↗ · v1.0.6 · MIT-0
cross-platform ✓ Security Clean
173
Downloads
0
Stars
1
Active Installs
7
Versions
Install in OpenClaw
/install justoneapi-search
Description
Analyze Social Media workflows with JustOneAPI, including cross-Platform Search.
README (SKILL.md)

Social Media

This skill wraps 1 Social Media operations exposed by JustOneAPI. It is strongest for cross-Platform Search. Expect common inputs such as end, keyword, nextCursor, source, start.

When To Use It

  • The user needs cross-Platform Search on Social Media.
  • The user can provide identifiers or filters such as end, keyword, nextCursor, source.
  • The user wants an exact API-backed answer instead of a freeform summary.

Representative Operations

  • searchCrossPlatformV1: Cross-Platform Search — Get cross-platform social media search data, including Xiaohongshu, Douyin, Kuaishou, WeChat, Bilibili, Weibo and Zhihu results, for trend research and monitoring

Request Pattern

  • 1 operations are available in this skill.
  • HTTP methods used here: GET.
  • The most common non-token parameters are end, keyword, nextCursor, source, start.
  • All operations in this skill are parameter-driven requests; none require a request body.

How To Work

  1. Read generated/operations.md before choosing an endpoint.
  2. Start with one of these operations when it matches the user's request: searchCrossPlatformV1.
  3. Pick the smallest matching operation instead of guessing.
  4. Ask the user for any missing required parameter. Do not invent values.
  5. Call the helper with:
node {baseDir}/bin/run.mjs --operation "\x3Coperation-id>" --token "$JUST_ONE_API_TOKEN" --params-json '{"key":"value"}'

Environment

  • Required: JUST_ONE_API_TOKEN
  • This skill uses JUST_ONE_API_TOKEN only for authenticated Just One API requests.
  • Keep JUST_ONE_API_TOKEN private. Do not paste it into chat messages, screenshots, or logs.
  • Get a token from Just One API Dashboard.
  • Authentication details: Just One API Usage Guide.

Output Rules

  • Start with a plain-language answer tied to the Social Media task the user asked for.
  • Include the most decision-relevant fields from the selected endpoint before dumping raw JSON.
  • When using searchCrossPlatformV1, explain why the returned fields answer the user's question.
  • If the user gave filters such as end, keyword, nextCursor, echo those back so the scope is explicit.
  • If the backend errors, include the backend payload and the exact operation ID.
Usage Guidance
This skill appears to do what it says. Before installing: 1) Only provide a JustOneAPI token with minimal necessary permissions and never paste it into chat or logs. 2) Be aware the token is sent as a query parameter (could be logged or leaked via referer); if this matters for your security posture, avoid using high-privilege tokens or confirm the provider's logging/retention policies. 3) Responses are printed as full JSON and may include personal data from social platforms—treat outputs as sensitive. 4) If you prefer tighter control, consider not granting autonomous invocation or restricting the token you supply.
Capability Tags
requires-oauth-tokenrequires-sensitive-credentials
Capability Assessment
Purpose & Capability
The skill's name/description (cross-platform social media search) matches the declared requirements and code. It only requires node and JUST_ONE_API_TOKEN, which are appropriate for calling the JustOneAPI endpoints described.
Instruction Scope
Runtime instructions and bin/run.mjs implement a single GET operation to https://api.justoneapi.com/api/search/v1 using the provided token and query parameters. This stays within the stated purpose. One privacy/security note: the token is sent as a URL query parameter (parameter name 'token'), which can be logged by servers/proxies or leak via Referer headers — using a header-based auth would be safer. The tool also prints full JSON responses to stdout (expected) which may contain PII from social media results; handle outputs accordingly.
Install Mechanism
No install spec is provided and the skill relies on an included node script and the system node binary. No downloads or external installers are invoked by the skill itself.
Credentials
Only a single credential (JUST_ONE_API_TOKEN) is required and is used exclusively for authenticating to JustOneAPI as documented in SKILL.md. There are no unrelated environment variables or config paths requested.
Persistence & Privilege
The skill does not request always:true and does not attempt to modify other skills or system-wide settings. Model invocation is allowed (the platform default), which is expected for a network API integration.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install justoneapi-search
  3. After installation, invoke the skill by name or use /justoneapi-search
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.6
- Operation name updated from searchV1 to searchCrossPlatformV1 across documentation and helper files. - All references to the operation updated to maintain consistency. - SKILL.md and operations documentation revised to use the new operation name. - No user-facing parameter or functionality changes.
v1.0.5
- Updated the authentication details link in the Environment section for better guidance. - No functional or endpoint changes—documentation update only.
v1.0.4
- Updated the Just One API dashboard link to include referral parameters. - No changes to functionality or behavior; documentation link now provides clearer attribution.
v1.0.3
Version 1.0.3 - SKILL.md updated to clarify the use of JUST_ONE_API_TOKEN for authenticated API requests. - Added explicit note that JUST_ONE_API_TOKEN is used only for Just One API authentication. - No changes to functionality or available operations; documentation only.
v1.0.2
- Added a reminder to keep the `JUST_ONE_API_TOKEN` private and not to share it in chat messages, screenshots, or logs. - No changes to operations, parameters, or API behavior. - Documentation update only; usage and output rules remain the same.
v1.0.1
Version 1.0.1 – Minor Update - Added instructions on where to obtain the required JUST_ONE_API_TOKEN. - Included links to the Just One API Dashboard and API Usage Guide for authentication. - No changes to the core functionality or behavior of the skill.
v1.0.0
init
Metadata
Slug justoneapi-search
Version 1.0.6
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 7
Frequently Asked Questions

What is Social Media API?

Analyze Social Media workflows with JustOneAPI, including cross-Platform Search. It is an AI Agent Skill for Claude Code / OpenClaw, with 173 downloads so far.

How do I install Social Media API?

Run "/install justoneapi-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Social Media API free?

Yes, Social Media API is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Social Media API support?

Social Media API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Social Media API?

It is built and maintained by justoneapi (@justoneapi); the current version is v1.0.6.

💬 Comments