← 返回 Skills 市场
justoneapi

Beike Community List API

作者 justoneapi · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ✓ 安全检测通过
103
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install justoneapi-beike-community-list
功能描述
Call GET /api/beike/community/list/v1 for Beike Community List through JustOneAPI with cityId.
使用说明 (SKILL.md)

Beike Community List

Use this focused JustOneAPI skill for community List in Beike. It targets GET /api/beike/community/list/v1. Required non-token inputs are cityId. OpenAPI describes it as: Get Beike community List data, including - Community name and unique ID and Average listing price and historical price trends, for identifying popular residential areas in a city and comparing average housing prices across different communities.

Endpoint Scope

  • Platform key: beike
  • Endpoint key: community/list
  • Platform family: Beike
  • Skill slug: justoneapi-beike-community-list
Operation Version Method Path OpenAPI summary
communityListV1 v1 GET /api/beike/community/list/v1 Community List

Inputs

Parameter In Required by Optional by Type Notes
cityId query all n/a string The ID of the city (e.g., '110000' for Beijing)
condition query n/a all string Filter conditions for communities
limitOffset query n/a all integer Pagination offset, starting from 0 (e.g., 0, 20, 40...)

Request body: none documented; send parameters through path or query arguments.

Version Choice

Use communityListV1 for the documented v1 endpoint. There are no alternate versions grouped in this skill.

Run This Endpoint

Supported operation IDs in this skill: communityListV1.

node {baseDir}/bin/run.mjs --operation "communityListV1" --token "$JUST_ONE_API_TOKEN" --params-json '{"cityId":"\x3CcityId>"}'

Ask for any missing required parameter before calling the helper. Keep user-provided IDs, cursors, keywords, and filters unchanged.

Environment

  • Required: JUST_ONE_API_TOKEN
  • Pass the token with --token "$JUST_ONE_API_TOKEN"; do not paste token values into chat messages, screenshots, or logs.
  • Get a token from Just One API Dashboard.
  • Authentication details: Just One API Usage Guide.

Output Focus

  • State the operation ID and endpoint path used, for example communityListV1 on /api/beike/community/list/v1.
  • Echo the required lookup scope (cityId) before summarizing results.
  • Prioritize fields that support this endpoint purpose: Get Beike community List data, including - Community name and unique ID and Average listing price and historical price trends, for identifying popular residential areas in a city and comparing average housing prices across different communities.
  • Return raw JSON only after the short, endpoint-specific summary.
  • If the backend errors, include the backend payload and the exact operation ID.
安全使用建议
This skill appears to do what it says: a thin Node-based wrapper around JustOneAPI's Beike community list endpoint. Before installing: 1) Only provide a JustOneAPI token with minimal scope and rotate it if compromised. 2) Be aware the token is sent as a URL query parameter by the script—this can be logged by servers, proxies, or appear in referer headers—so avoid using highly privileged tokens. 3) The script prints raw backend payloads on error, which could include sensitive data; review outputs before sharing. 4) Review the included bin/run.mjs locally and ensure your system's Node version supports global fetch (Node 18+ or polyfill). If you need lower exposure, modify the script to send the token in an Authorization header and avoid printing sensitive fields.
功能分析
Type: OpenClaw Skill Name: justoneapi-beike-community-list Version: 1.0.2 The skill is a standard API wrapper for retrieving Beike community data via JustOneAPI. The implementation in bin/run.mjs is straightforward, using the native fetch API to communicate with api.justoneapi.com. No indicators of malicious intent, data exfiltration, or harmful prompt injection were found in SKILL.md or the code logic.
能力评估
Purpose & Capability
Name/description, required binary (node), and required env var (JUST_ONE_API_TOKEN) match the included code and the declared purpose of calling JustOneAPI's /api/beike/community/list/v1. No unrelated credentials, binaries, or config paths are requested.
Instruction Scope
SKILL.md and bin/run.mjs instruct only a single GET to the documented endpoint and to echo the cityId and results. However, the implementation injects the token as a query parameter named 'token' (not an Authorization header) and prints raw backend payloads on error; tokens in query strings can be exposed in server logs, proxies, and referer headers and error payloads may contain sensitive details.
Install Mechanism
No install spec (instruction-only plus a small included Node script). There are no downloads or archive extractions; nothing is written to disk beyond the included files. Low installation risk.
Credentials
Only one credential (JUST_ONE_API_TOKEN) is required, which is appropriate for a remote API call. As above, the token is passed as a query parameter by the script which increases exposure risk compared with using an Authorization header.
Persistence & Privilege
The skill is not always-enabled, is user-invocable, does not request elevated system presence or modify other skills/configurations, and does not require persistent installation steps.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install justoneapi-beike-community-list
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /justoneapi-beike-community-list 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.2
Version 1.0.2 - SKILL.md rewritten for clarity: focuses on single endpoint, with more concise input/output instructions. - Highlights required input (`cityId`) and operation details. - Output guidance now directs to state operation ID and query scope before summarizing results. - Minor technical references and extraneous guidance removed for brevity. - No changes to endpoint logic or parameters.
v1.0.1
justoneapi-beike-community-list 1.0.1 - Internal maintenance: updated generated/operations.json and generated/operations.md with the latest API structure. - No user-facing feature changes or adjustments to API workflows. - Documentation and environment instructions remain unchanged.
v1.0.0
Initial publish
元数据
Slug justoneapi-beike-community-list
版本 1.0.2
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 3
常见问题

Beike Community List API 是什么?

Call GET /api/beike/community/list/v1 for Beike Community List through JustOneAPI with cityId. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 103 次。

如何安装 Beike Community List API?

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

Beike Community List API 是免费的吗?

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

Beike Community List API 支持哪些平台?

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

谁开发了 Beike Community List API?

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

💬 留言讨论