← 返回 Skills 市场
Facebook
Facebook API
作者
justoneapi
· GitHub ↗
· v1.0.9
· MIT-0
210
总下载
0
收藏
1
当前安装
10
版本数
在 OpenClaw 中安装
/install justoneapi-facebook
功能描述
Analyze Facebook workflows with JustOneAPI, including post Search, get Profile ID, and get Profile Posts.
使用说明 (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.
安全使用建议
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.
功能分析
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`.
能力评估
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.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install justoneapi-facebook - 安装完成后,直接呼叫该 Skill 的名称或使用
/justoneapi-facebook触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
常见问题
Facebook API 是什么?
Analyze Facebook workflows with JustOneAPI, including post Search, get Profile ID, and get Profile Posts. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 210 次。
如何安装 Facebook API?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install justoneapi-facebook」即可一键安装,无需额外配置。
Facebook API 是免费的吗?
是的,Facebook API 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Facebook API 支持哪些平台?
Facebook API 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Facebook API?
由 justoneapi(@justoneapi)开发并维护,当前版本 v1.0.9。
推荐 Skills