Beike API

Analyze Beike workflows with JustOneAPI, including resale Housing Details, resale Housing List, and community List.

Security Scan

The skill is coherent: it wraps three Beike endpoints on api.justoneapi.com, requires only a single API token and node, and its code and instructions match the stated purpose.

Purpose & Capability

Name/description match the included operations (communityListV1, ershoufangDetailV1, getErshoufangListV1). Required binary (node) and required env JUST_ONE_API_TOKEN are appropriate for running the provided Node CLI that calls JustOneAPI.

Instruction Scope

SKILL.md instructs the agent to pick one of the three GET endpoints, ask for missing parameters, and run the local helper (node bin/run.mjs). The instructions do not request unrelated files, credentials, or system state beyond the declared token and the generated operations doc.

Install Mechanism

No install spec; this is instruction-only with an included Node script. Nothing is downloaded or written to disk during install. The only runtime dependency is an existing node binary.

Credentials

Only JUST_ONE_API_TOKEN is required, which is proportional to the API calls. Note: the CLI injects the token as a query parameter named 'token' (not an Authorization header), so the token may appear in URLs and could be logged by servers or proxies—consider using a token with limited scope and avoid sharing logs that contain request URLs.

Persistence & Privilege

always is false and the skill does not modify other skills or system settings. It only uses the token at runtime and prints API responses to stdout.

Assessment

This skill appears to do exactly what it claims: call JustOneAPI Beike endpoints. If you install it, provide a JUST_ONE_API_TOKEN scoped for this service only. Be aware the token is sent in the URL query string (may be logged by intermediaries); if that is a concern, request a token with limited permissions or confirm with the API provider whether a header-based auth option exists. Also ensure node is available on the host where the agent will run and review JustOneAPI's privacy/security policy if you plan to send sensitive queries.

Beike

This skill wraps 3 Beike operations exposed by JustOneAPI. It is strongest for resale Housing Details, resale Housing List, and community List. Expect common inputs such as cityId, condition, houseCode, limitOffset, offset.

When To Use It

• The user needs resale Housing Details or resale Housing List on Beike.
• The task lines up with community List rather than a generic cross-platform workflow.
• The user can provide identifiers or filters such as cityId, condition, houseCode, limitOffset.
• The user wants an exact API-backed answer instead of a freeform summary.

Representative Operations

• ershoufangDetailV1: Resale Housing Details — Get Beike resale Housing Details data, including - Pricing (total and unit price), Physical attributes (area, and layout, for displaying a full property profile to users and detailed price comparison between specific listings
• getErshoufangListV1: Resale Housing List — Get Beike resale Housing List data, including - Supports filtering by city/region, price range, and layout, for building search result pages for property portals and aggregating market data for regional housing trends
• communityListV1: Community List — 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

Request Pattern

• 3 operations are available in this skill.
• HTTP methods used here: GET.
• The most common non-token parameters are cityId, condition, houseCode, limitOffset, offset.
• 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: ershoufangDetailV1, getErshoufangListV1, communityListV1.
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 "<operation-id>" --token "$JUST_ONE_API_TOKEN" --params-json '{"key":"value"}'

Environment

• Required: JUST_ONE_API_TOKEN

Output Rules

• Start with a plain-language answer tied to the Beike task the user asked for.
• Include the most decision-relevant fields from the selected endpoint before dumping raw JSON.
• When using ershoufangDetailV1, explain why the returned fields answer the user's question.
• If the user gave filters such as cityId, condition, houseCode, echo those back so the scope is explicit.
• If the backend errors, include the backend payload and the exact operation ID.