← 返回 Skills 市场
justoneapi

Instagram API

作者 justoneapi · GitHub ↗ · v1.0.8 · MIT-0
cross-platform ⚠ suspicious
199
总下载
0
收藏
1
当前安装
9
版本数
在 OpenClaw 中安装
/install justoneapi-instagram
功能描述
Analyze Instagram workflows with JustOneAPI, including user Profile, post Details, and user Published Posts across 5 operations.
使用说明 (SKILL.md)

Instagram

This skill wraps 5 Instagram operations exposed by JustOneAPI. It is strongest for user Profile, post Details, user Published Posts, and reels Search. Expect common inputs such as paginationToken, username, code, endCursor, hashtag.

When To Use It

  • The user needs user Profile or post Details on Instagram.
  • The task lines up with user Published Posts rather than a generic cross-platform workflow.
  • The user can provide identifiers or filters such as paginationToken, username, code, endCursor.
  • The user wants an exact API-backed answer instead of a freeform summary.

Representative Operations

  • getInstagramUserDetailV1: User Profile — Get Instagram user Profile data, including follower count, following count, and post count, for obtaining basic account metadata for influencer vetting, tracking follower growth and audience reach over time, and mapping user handles to specific profile stats
  • getInstagramPostDetailV1: Post Details — Get Instagram post Details data, including post caption, media content (images/videos), and publish time, for analyzing engagement metrics (likes/comments) for a specific post and archiving post content and media assets for content analysis
  • getInstagramUserPostsV1: User Published Posts — Get Instagram user Published Posts data, including post code, caption, and media type, for monitoring recent publishing activity of a specific user and building a historical record of content for auditing or analysis
  • searchReelsV1: Reels Search — Get Instagram reels Search data, including post ID, caption, and author profile, for tracking trends and viral content via specific keywords or hashtags and discovering high-engagement reels within a particular niche

Request Pattern

  • 5 operations are available in this skill.
  • HTTP methods used here: GET.
  • The most common non-token parameters are paginationToken, username, code, endCursor, hashtag.
  • 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: getInstagramUserDetailV1, getInstagramPostDetailV1, getInstagramUserPostsV1, searchReelsV1.
  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 Instagram task the user asked for.
  • Include the most decision-relevant fields from the selected endpoint before dumping raw JSON.
  • When using getInstagramUserDetailV1, explain why the returned fields answer the user's question.
  • If the user gave filters such as paginationToken, username, code, echo those back so the scope is explicit.
  • If the backend errors, include the backend payload and the exact operation ID.
安全使用建议
This skill legitimately wraps JustOneAPI Instagram endpoints and needs JUST_ONE_API_TOKEN, so functionality is coherent. The main risk is secret exposure: the provided usage example passes your token on the command line and the script appends it to the URL query — both can leak the token to process listings, shell history, or logs. Before installing or using: (1) Prefer running the script in a secure/isolated environment (dedicated VM/container) if you must pass the token this way. (2) Consider modifying bin/run.mjs to read JUST_ONE_API_TOKEN from process.env (not a CLI arg) and send it in an Authorization header if the API supports it, to avoid exposing it in argv and URLs. (3) Use a least-privilege, short-lived token if possible and rotate it after testing. (4) Review JustOneAPI's privacy/logging policy (requests go to api.justoneapi.com) and confirm you trust the provider with the requested Instagram data. (5) If you are not comfortable modifying code, avoid passing long-lived secrets on the CLI and do not paste tokens into chat or screenshots.
功能分析
Type: OpenClaw Skill Name: justoneapi-instagram Version: 1.0.8 The skill is a standard API wrapper for JustOneAPI's Instagram services, providing functionality to retrieve user profiles, post details, and search reels. The implementation in `bin/run.mjs` is a straightforward Node.js script that uses the built-in fetch API to communicate exclusively with the legitimate domain `api.justoneapi.com`. No evidence of data exfiltration, malicious execution, or prompt injection was found.
能力标签
requires-oauth-tokenrequires-sensitive-credentials
能力评估
Purpose & Capability
Name/description, required binary (node), and declared env var (JUST_ONE_API_TOKEN) match the included manifest and code. All endpoints are on api.justoneapi.com and correspond to Instagram profile/post/hashtag/reels operations described in the SKILL.md and generated OpenAPI artifacts.
Instruction Scope
The SKILL.md instructs calling the bundled Node script with: node bin/run.mjs --operation "..." --token "$JUST_ONE_API_TOKEN" --params-json '...'. Passing the secret via a CLI flag (and the script then inserts it as a query parameter named 'token') risks exposing the token in process listings, shell history, and proxy/server logs. Aside from that secret-handling issue, the instructions stay within the stated purpose and do not request unrelated files or credentials.
Install Mechanism
No remote install or downloads are performed; the skill is instruction/code-only and requires an existing 'node' binary. No external archives, package installs, or unusual install locations are used.
Credentials
Only one env var (JUST_ONE_API_TOKEN) is required, which is proportionate to the API integration. However, the implementation sends that token as a query parameter and the SKILL.md instructs passing it on the command line — both increase the chance of accidental exposure (process lists, shell history, server logs). The token request itself is otherwise justified by the skill's purpose.
Persistence & Privilege
The skill does not request persistent/always-on privileges and does not modify other skills or system configuration. Autonomous invocation is allowed (platform default) but not combined with other elevated privileges.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install justoneapi-instagram
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /justoneapi-instagram 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.8
- Operation IDs updated: now use getInstagramUserDetailV1, getInstagramPostDetailV1, getInstagramUserPostsV1 instead of previous names. - SKILL.md updated to reflect new operation IDs throughout usage guidance and representative operations. - Generated documentation (operations.json, operations.md) synced to match new operation naming. - No changes to core functionality or required environment variables.
v1.0.7
- Updated authentication details link in the Environment section for improved onboarding. - Adjusted URLs to include UTM parameters for referral tracking. - No functional changes to operations or usage.
v1.0.6
- Updated the Just One API Dashboard link to include UTM parameters for improved referral tracking. - No functional changes to skill logic or usage instructions.
v1.0.5
Version 1.0.5 - Updated SKILL.md to clarify token usage in the Environment section. - Added that `JUST_ONE_API_TOKEN` is used solely for authenticated Just One API requests.
v1.0.4
- Clarified that the `JUST_ONE_API_TOKEN` environment variable must be kept private and not shared in chat messages, screenshots, or logs. - No changes in endpoints, operations, or parameter usage. All descriptions and usage patterns remain the same.
v1.0.3
Version 1.0.3 - Updated SKILL.md with instructions on obtaining the required API token from the Just One API Dashboard. - Added documentation links for authentication and usage details to assist users.
v1.0.2
rename
v1.0.1
- Updated the skill name in documentation from "justoneapi_instagram" to "Instagram API" for improved clarity. - No changes to codebase, endpoints, or functional behavior—documentation only.
v1.0.0
justoneapi-instagram 1.0.0 - Initial release of the JustOneAPI Instagram integration skill. - Supports 5 key Instagram data operations: user Profile, post Details, user Published Posts, and reels Search. - Enables precise, parameter-driven Instagram queries using fields like `username`, `code`, and `hashtag`. - Provides a clear step-by-step usage guide and recommended output practices for API-backed answers.
元数据
Slug justoneapi-instagram
版本 1.0.8
许可证 MIT-0
累计安装 1
当前安装数 1
历史版本数 9
常见问题

Instagram API 是什么?

Analyze Instagram workflows with JustOneAPI, including user Profile, post Details, and user Published Posts across 5 operations. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 199 次。

如何安装 Instagram API?

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

Instagram API 是免费的吗?

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

Instagram API 支持哪些平台?

Instagram API 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Instagram API?

由 justoneapi(@justoneapi)开发并维护,当前版本 v1.0.8。

💬 留言讨论