nexscope-ai/nexscope-ecommerce-skills / ecommerce-ruiguan-gun-parts-search
ecommerce.ruiguan-gun-parts-search
VerifiedCheck product images against a database of policy-violating items using visual similarity matching. Triggered when users mention policy compliance check, product image compliance review, violation detection, prohibited product screening, image-based compliance audit, pre-listing risk screening, or product image risk check. Even if the user does not explicitly say "compliance," this skill should be triggered whenever the need involves comparing product images against a violation database.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.4 KB |
| manifest.json | config | 521 B |
| references/api.md | markdown | 5.3 KB |
| scripts/ruiguan_image_compliance_search.py | script | 6.2 KB |
| scripts/upload_image.py | script | 9.6 KB |
SKILL.md
View on GitHub---
name: ecommerce.ruiguan-gun-parts-search
description: Check product images against a database of policy-violating items using visual similarity matching. Triggered when users mention policy compliance check, product image compliance review, violation detection, prohibited product screening, image-based compliance audit, pre-listing risk screening, or product image risk check. Even if the user does not explicitly say "compliance," this skill should be triggered whenever the need involves comparing product images against a violation database.
---
# Policy Compliance Image Detection
This skill guides you on how to use the policy compliance detection tool to identify potential policy violations in product images. It performs image-based similarity search against a known database of prohibited products.
## Core Concepts
Policy Compliance Image Detection is an image-based compliance screening service. Given a product image URL, it searches for visually similar products in a database of known policy-violating items. The tool returns matching violations ranked by visual similarity.
**Similarity score (cosine)**: A value between 0 and 1. Higher values indicate stronger visual resemblance to known violating products. A score close to 1.0 means the product image is nearly identical to a flagged violation.
## Parameter Guide
| Parameter | Type | Required | Description | Example |
|-----------|------|----------|-------------|---------|
| Image URL | imageUrl | Yes | The URL of the product image to check (max 1000 chars) | https://example.com/product.jpg |
**Key notes:**
- The image URL must be publicly accessible
- Supported formats include common image types (JPG, PNG, etc.)
- The URL must not exceed 1000 characters
## Response Fields
| Field | API Name | Description |
|-------|----------|-------------|
| Total Matches | total | Number of matching violation records found |
| Violation List | data | Array of matched violating products |
| Violation Image | pdImgOssUrl | Image URL of the matched violating product |
| Similarity Score | cosine | Similarity between the input image and the violation (0~1) |
| Product Title (EN) | pdTitle | English title of the matched violating product |
| Product Title (CN) | pdTitleCHNCensored | Chinese title of the matched violating product |
| Detection ID | detectId | Unique identifier for this detection session |
| Token Cost | costToken | Number of tokens consumed by this request |
## Usage
- **API Endpoint**: `POST /ruiguan/gunPartsSearch` (see `references/api.md` for full parameters, responses, and error codes)
- **Python Script**: `python scripts/ruiguan_image_compliance_search.py '<JSON parameters>'`
**Output strategy (script default behavior)**:
- Prints the full JSON response to stdout
**Data reading tip**: Use `jq` or `ConvertFrom-Json` to extract specific fields from the response as needed.
## Usage Examples
**1. Basic compliance check for a single product image**
```
Check this product image for policy compliance: https://example.com/images/product-123.jpg
```
**2. Batch checking multiple product images**
```
Please scan these product images for potential policy violations:
- https://example.com/images/item-a.jpg
- https://example.com/images/item-b.jpg
```
**3. Pre-listing compliance screening**
```
Before I list this product, can you check if the image triggers any policy flags?
Image: https://example.com/new-product.png
```
## Display Rules
1. **Show results in a clear table**: Present each matched violation with its image, similarity score, and product titles
2. **Highlight high-similarity matches**: When the cosine score exceeds 0.8, clearly flag the result as a strong match that likely requires attention
3. **Include violation images**: When results contain `pdImgOssUrl`, display the matched violation image so the user can visually compare
4. **Score interpretation**: Always explain what the similarity score means -- higher values indicate closer resemblance to known violations
5. **Error handling**: When a query fails, explain the issue and suggest checking whether the image URL is valid and publicly accessible
6. **No legal advice**: Present detection results factually without providing legal conclusions; remind users to verify with platform policies
## Important Limitations
- **Image-only detection**: This tool works exclusively with image URLs; it does not analyze text descriptions or product metadata
- **URL accessibility**: The image URL must be publicly reachable by the detection service
- **URL length cap**: Image URLs must not exceed 1000 characters
- **Similarity-based**: Results are based on visual similarity and do not constitute a definitive policy ruling
## User Expression & Scenario Quick Reference
**Applicable** -- Image-based product policy compliance checks:
| User Says | Scenario |
|-----------|----------|
| "Check if this product image has compliance risks" | Single image compliance check |
| "Scan my product images for policy violations" | Batch compliance screening |
| "Is this image flagged as a prohibited product" | Specific violation inquiry |
| "Pre-screen my listing images for policy risks" | Pre-listing compliance audit |
| "Find similar violations for this product image" | Similarity-based violation search |
**Not applicable** -- Needs beyond image-based policy compliance detection:
- Text-based product compliance analysis
- General product category classification
- Intellectual property / trademark infringement
- Patent or copyright detection (use other detection skills)
## Authentication
Set `NEXSCOPE_API_KEY`. Visit https://www.nexscope.ai/help/skills-external-access?co-from=skillNS to manage credits.
## API Key request rate
All Nexscope API Keys belonging to the same user share one request-rate allowance for public API execution. The allowance is measured over any rolling 1-second window. Your RPS depends on your account entitlements; do not assume every user has a fixed 1 RPS. A single Skill operation may make multiple public API requests, and each request uses this allowance.
If an execution request returns HTTP 429 with outer code `13012`, the request-rate allowance was exceeded. Honor the returned `Retry-After` before considering another request. Outer code `13013` means the concurrent-request limit was exceeded, not the rate limit; honor its `Retry-After` when supplied. Inspect the response and reconcile state before retrying. Never automatically replay a write operation or a request whose outcome is unclear.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |