Design Similarity Search

Use the bundled Python 3.9+ standard-library client. Set NEXSCOPE_API_KEY and optionally NEXSCOPE_PROXY_BASE=https://api.nexscope.ai. Nexscope handles source signing on its backend. Invoking this Skill consumes credits; never treat source pricing or account usage as the user's Nexscope price or balance.

Workflow

1. Use the image supplied or explicitly selected by the user. Supply exactly one of imageUrl and pure imageBase64; no title-only search. Local image bytes can be Base64-encoded without any upload helper.

2. Read references/api.md. Apply only the user's requested filters; preserve leading zeros in classification strings. Do not silently choose a region or active/inactive preference.

3. Prepare a UTF-8 JSON file. Run a validation-only plan:

   python scripts/design_similarity.py --params-file request.json
   

4. After applicable approval of credit consumption, add --execute. The client sends at most one request, follows no redirects, makes no retries and saves the full response locally. --inline displays it; otherwise it prints a bounded summary.

5. Require HTTP success, platform numeric code:0, and source data.data.code:"OK" in the complete platform response. Candidate data is at data.data.data. An error or missing coverage is not zero matches.

6. Present actual candidates in source order with identifiers, holder/designer, status, similarity and coverage when returned. Return the absolute result-file path. Missing/null metadata stays unknown.

Output rules