← Back to Skills Marketplace
Facebook
Facebook API
by
justoneapi
· GitHub ↗
· v1.0.9
· MIT-0
210
Downloads
0
Stars
1
Active Installs
10
Versions
Install in OpenClaw
/install justoneapi-facebook
Description
Analyze Facebook workflows with JustOneAPI, including post Search, get Profile ID, and get Profile Posts.
README (SKILL.md)
This skill wraps 3 Facebook operations exposed by JustOneAPI. It is strongest for post Search, get Profile ID, and get Profile Posts. Expect common inputs such as cursor, endDate, keyword, profileId, startDate.
When To Use It
- The user needs post Search or get Profile ID on Facebook.
- The task lines up with get Profile Posts rather than a generic cross-platform workflow.
- The user can provide identifiers or filters such as
cursor,endDate,keyword,profileId. - The user wants an exact API-backed answer instead of a freeform summary.
Representative Operations
searchFacebookPostsV1: Post Search — Get Facebook post Search data, including matched results, metadata, and ranking signals, for discovering relevant public posts for specific keywords and analyzing engagement and reach of public content on facebookgetProfileIdV1: Get Profile ID — Retrieve the unique Facebook profile ID from a given profile URLgetProfilePostsV1: Get Profile Posts — Get public posts from a specific Facebook profile using its profile ID
Request Pattern
- 3 operations are available in this skill.
- HTTP methods used here:
GET. - The most common non-token parameters are
cursor,endDate,keyword,profileId,startDate. - All operations in this skill are parameter-driven requests; none require a request body.
How To Work
- Read
generated/operations.mdbefore choosing an endpoint. - Start with one of these operations when it matches the user's request:
searchFacebookPostsV1,getProfileIdV1,getProfilePostsV1. - Pick the smallest matching operation instead of guessing.
- Ask the user for any missing required parameter. Do not invent values.
- 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_TOKENonly for authenticated Just One API requests. - Keep
JUST_ONE_API_TOKENprivate. 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 Facebook task the user asked for.
- Include the most decision-relevant fields from the selected endpoint before dumping raw JSON.
- When using
searchFacebookPostsV1, explain why the returned fields answer the user's question. - If the user gave filters such as
cursor,endDate,keyword, 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 looks like a straightforward wrapper around JustOneAPI's Facebook endpoints and only needs a single API token and node to run. Before installing: (1) Treat JUST_ONE_API_TOKEN as sensitive — avoid passing it as a visible CLI argument if possible (that can expose it in process listings and shell history). Prefer securely storing the token in your platform's secret store or modify the script to read the token from an environment variable or stdin. (2) Be aware the token will be sent as a query parameter to https://api.justoneapi.com and could appear in remote logs or referer data. (3) Confirm the token's scope/permissions on JustOneAPI and rotate it if you later remove the skill. (4) If you need stronger guarantees, review the included bin/run.mjs source yourself (it only performs GET requests and prints JSON) or request a version that sends the token via an Authorization header instead of query parameters.
Capability Analysis
Type: OpenClaw Skill
Name: justoneapi-facebook
Version: 1.0.9
The skill is a standard API wrapper for JustOneAPI's Facebook endpoints (search, profile ID, and posts). The execution logic in `bin/run.mjs` is transparent, uses standard Node.js fetch, and contains no evidence of data exfiltration, obfuscation, or malicious intent. While the API design passes authentication tokens via query parameters (a minor security vulnerability), the skill itself behaves exactly as described in `SKILL.md`.
Capability Assessment
Purpose & Capability
Name/description, declared binary requirement (node), required env var (JUST_ONE_API_TOKEN), and the included operations (search posts, get profile ID, get profile posts) all align. The manifest baseUrl points to api.justoneapi.com which matches the claimed provider.
Instruction Scope
SKILL.md and bin/run.mjs restrict actions to calling JustOneAPI GET endpoints and returning JSON. They do not read other files or unrelated env vars. One operational note: the instructions show passing the token as a CLI argument (--token "$JUST_ONE_API_TOKEN"), which can expose the secret in process listings, shell history, and logs; the script then places the token into query parameters, which may appear in remote logs or referer headers.
Install Mechanism
No install spec; this is instruction-only plus an included Node script. No external installers, downloads, or extracted archives are used. Risk is limited to running the provided script with node.
Credentials
Only JUST_ONE_API_TOKEN is required and is the primary credential for the declared API. That is proportionate. Caveat: the token is passed to the helper as a CLI argument and sent as a query parameter, which increases exposure risk (process lists, histories, server logs, referer).
Persistence & Privilege
Skill is user-invocable, not always-enabled, and does not request persistent or cross-skill configuration. Autonomous invocation is allowed but is the platform default and not coupled with additional privileges here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install justoneapi-facebook - After installation, invoke the skill by name or use
/justoneapi-facebook - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.9
- Renamed the post search operation from searchV1 to searchFacebookPostsV1 across documentation and code.
- Updated instructions and examples in SKILL.md and generated docs to use the new operation ID.
- No changes to inputs, outputs, or authentication requirements.
- Minor clarifications in documentation for consistency.
v1.0.8
- Updated the Just One API usage guide link to include tracking parameters for better referral attribution.
- No functional changes; documentation update only.
v1.0.7
- Updated the Just One API dashboard link in the Environment section to include tracking parameters and direct login.
- No functional or behavioral changes to the skill logic or endpoints.
v1.0.6
- Clarified that JUST_ONE_API_TOKEN is used only for authenticated Just One API requests.
- Added a line in the Environment section to explicitly state this usage.
- No changes to functionality or operations—documentation update only.
v1.0.5
Version 1.0.5
- Updated the SKILL.md file to clarify environment token handling.
- Added explicit instruction to keep the JUST_ONE_API_TOKEN private and not share it in chat messages, screenshots, or logs.
- No changes to core functionality or endpoints.
v1.0.4
Version 1.0.4
- Added instructions for obtaining the required API token from the Just One API Dashboard.
- Linked to the official Just One API usage guide for authentication details.
- No changes to functionality; documentation improvements only.
v1.0.3
rename
v1.0.2
- Changed skill name in documentation from "justoneapi_facebook" to "Facebook API".
- No changes to usage, features, or operations; documentation updated only.
- All usage instructions, endpoints, and guidance remain the same.
v1.0.1
- Improved and clarified SKILL.md documentation, emphasizing 3 key Facebook operations: search posts, get profile ID, and get profile posts.
- Updated usage guidance to reflect supported inputs like cursor, endDate, keyword, profileId, and startDate.
- Added explicit operation descriptions and examples for post Search, get Profile ID, and get Profile Posts.
- Refined output and error-handling instructions for more helpful, user-focused responses.
v1.0.0
Initial release of the justoneapi-facebook skill:
- Integrates JustOneAPI Facebook endpoints via HTTP APIs.
- Guides users to fetch data and interact with JustOneAPI Facebook-related endpoints.
- Requires the JUST_ONE_API_TOKEN environment variable for authentication.
- Provides usage instructions and output formatting rules for clear, structured results.
Metadata
Frequently Asked Questions
What is Facebook API?
Analyze Facebook workflows with JustOneAPI, including post Search, get Profile ID, and get Profile Posts. It is an AI Agent Skill for Claude Code / OpenClaw, with 210 downloads so far.
How do I install Facebook API?
Run "/install justoneapi-facebook" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Facebook API free?
Yes, Facebook API is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Facebook API support?
Facebook API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Facebook API?
It is built and maintained by justoneapi (@justoneapi); the current version is v1.0.9.
More Skills