Ruiguan Text Trademark

面向电商产品Listing的文字商标检测与侵权风险分析。当用户提到商标检测、商标风险检查、品牌侵权筛查、产品标题商标扫描、文字商标查询、Listing合规检查、知识产权风险评估、text trademark detection, trademark infringement, brand infringement...

Security Scan

The skill's functionality (calling a LinkFox trademark API) is coherent, but the package metadata omits a required API key and the runtime script will send user product text to an external endpoint — the missing credential declaration and external network calls are disproportionate and should be clarified before installing.

Purpose & Capability

Name/description match the implementation: the skill scans product text against a trademark database via LinkFox's ruiguan/textTrademarkDetection API. The included script and API reference align with the declared purpose.

Instruction Scope

SKILL.md and references instruct the agent to call an external API and to run scripts/ruiguan_text_trademark_detection.py which POSTs productTitle/productText to https://tool-gateway.linkfox.com/ruiguan/textTrademarkDetection. That behavior is expected for this skill, but the instructions reference an environment variable (LINKFOXAGENT_API_KEY) used for Authorization even though the skill metadata did not declare it — this mismatch can lead to unexpected credential use or agent attempts to locate secrets.

Install Mechanism

There is no install spec (instruction-only with a small helper script). No third-party package downloads or archive extraction are performed. The script uses Python stdlib network calls; nothing is being written to disk beyond the included files.

Credentials

The script and API reference require an API key via the LINKFOXAGENT_API_KEY environment variable, but the skill metadata lists no required env vars or primary credential. Sending product titles/text to an external API requires an API key and transmits user data to a third-party host; the missing declaration is an important omission and reduces transparency about what secrets will be used/exposed.

Persistence & Privilege

always:false and no install-time privileged modifications are present. The skill does not request permanent presence or attempt to modify other skills or system settings.

What to consider before installing

This skill appears to do what it claims (send product title/text to LinkFox for trademark checking), but the package metadata fails to declare the required LINKFOXAGENT_API_KEY. Before installing: 1) Confirm you trust the external host (tool-gateway.linkfox.com / skill-api.linkfox.com) and the publisher; 2) Ask the publisher to update metadata to declare LINKFOXAGENT_API_KEY as a required credential (so you know a secret is needed); 3) Only provide an API key scoped/minimized for this use and avoid sharing higher-privilege keys; 4) Be aware that product titles/descriptions will be transmitted off your system — do not send sensitive PII or unreleased product data you cannot expose; 5) If you can't verify LinkFox's reputation, avoid installing or run the script in an isolated environment and monitor network traffic; rotate the key if you suspect misuse.

Ruiguan Text Trademark Detection

This skill guides you on how to perform text-based trademark detection against product titles and other product text, helping e-commerce sellers identify potential trademark infringement risks before publishing listings.

Core Concepts

Text Trademark Detection scans product text (titles, descriptions, bullet points) against registered trademark databases across 15 countries/regions. It returns matched trademarks along with risk scores, registration details, and holder information so sellers can avoid intellectual property violations.

Risk score logic: The highestModeScore field ranges from 0 to 5 -- a higher value indicates greater infringement risk. The textTrademarkRadar field classifies overall product risk into three levels: 0 (low risk), 1 (needs manual review), 2 (high risk).

Blacklist and whitelist: The response may include blacklistTrademarks (known dangerous trademarks to always avoid) and whitelistTrademarks (safe trademarks that can be ignored). Always surface blacklist matches prominently to the user.

Parameters

Parameter	Type	Required	Description	Example
productTitle	string	Yes	Product title to scan (max 1000 chars)	Wireless Bluetooth Headphones Noise Cancelling
regions	string	No	Country/region codes, comma-separated. Supported: US, EM, GB, DE, FR, IT, ES, AU, CA, MX, JP, CN, WO, TR, BX	US,EM,GB
limit	integer	Yes	Max number of results to return (default 100, max 500)	100
productText	string	No	Additional product text such as bullet points, description (max 1000 chars)	Ergonomic design with premium sound quality

Supported Regions

Code	Region
US	United States
EM	European Union
GB	United Kingdom
DE	Germany
FR	France
IT	Italy
ES	Spain
AU	Australia
CA	Canada
MX	Mexico
JP	Japan
CN	China
WO	WIPO (World Intellectual Property Organization)
TR	Turkey
BX	Bolivia

When the user does not specify a region, default to US.

API Usage

This tool calls the LinkFox tool gateway API. See references/api.md for calling conventions, request parameters, and response structure. You can also execute scripts/ruiguan_text_trademark_detection.py directly to run queries.

How to Build Requests

Principles

1. Include the full product title: Always pass the complete product title in productTitle -- partial text may miss trademark matches.
2. Choose target regions: Select regions matching the marketplaces where the product will be sold. Use comma-separated codes for multi-region checks.
3. Provide additional text when available: If the user has bullet points, descriptions, or backend keywords, include them in productText for a more thorough scan.
4. Set an appropriate limit: Use the default of 100 for standard checks. Increase up to 500 when scanning titles with many potential matches.

Usage Examples

1. Basic US Trademark Check for a Product Title

productTitle: "Wireless Bluetooth Headphones Noise Cancelling Over Ear"
regions: "US"
limit: 100

2. Multi-Region Check (US + EU + UK)

productTitle: "Portable USB-C Charger Fast Charging Power Bank"
regions: "US,EM,GB"
limit: 100

3. Full Listing Scan with Additional Text

productTitle: "Stainless Steel Vacuum Insulated Water Bottle"
productText: "BPA-free, double-wall insulation, keeps drinks cold 24 hours, fits standard cup holders"
regions: "US,JP"
limit: 200

4. Broad Global Check

productTitle: "LED Ring Light with Tripod Stand for Streaming"
regions: "US,EM,GB,DE,FR,IT,ES,AU,CA,MX,JP,CN"
limit: 500

5. China Domestic Market Check

productTitle: "智能蓝牙耳机降噪头戴式"
regions: "CN"
limit: 100

Display Rules

1. Risk-first presentation: Always highlight the overall risk level (textTrademarkRadar) at the top of results. Use clear language: "Low Risk", "Needs Manual Review", or "High Risk".
2. Blacklist prominence: If blacklistTrademarks is non-empty, display them first with a clear warning.
3. Table format: Present trademark matches in a table with columns: Trademark Name, Region, Risk Score, Status, Holder, Application Number, Famous, Amazon Brand, Active Holder.
4. Score explanation: Remind users that highestModeScore ranges from 0 (safe) to 5 (highest risk).
5. Whitelist reassurance: If whitelistTrademarks contains entries, note them as safe/exempted trademarks.
6. Error handling: When a request fails, explain the issue and suggest the user check their product title or adjust regions.
7. No legal advice: Always remind users that results are for reference only and do not constitute legal advice. Recommend consulting an IP attorney for definitive trademark clearance.

Important Limitations

• Text-only detection: This tool detects trademarks in text. It does not analyze logos, images, or design marks.
• Result cap: Maximum 500 results per request.
• Character limit: Both productTitle and productText are limited to 1000 characters each.
• Database coverage: Covers 15 countries/regions. Trademarks registered in other jurisdictions may not be detected.

User Expression & Scenario Quick Reference

Applicable -- Trademark risk analysis for product text:

User Says	Scenario
"Check my title for trademark issues"	Basic trademark scan
"Is this product name safe to use"	Infringement risk check
"Scan my listing for brand violations"	Full listing scan
"Any trademark risks in this title"	Risk assessment
"Check trademarks in US and EU"	Multi-region check
"Is XX a registered trademark"	Specific term lookup
"Will my listing get taken down for IP"	Compliance screening
"Check if this keyword infringes any brand"	Keyword safety check

Not applicable -- Needs beyond text trademark detection:

• Logo or image-based trademark analysis
• Patent infringement checks
• Copyright detection
• Legal opinions or litigation strategy
• Trademark registration or filing assistance

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

1. The functionality or purpose described in this skill does not match actual behavior
2. The skill's results do not match the user's intent
3. The user expresses dissatisfaction or praise about this skill
4. Anything you believe could be improved

Call the feedback API as specified in references/api.md. Do not interrupt the user's flow.

---

For more high-quality, professional cross-border e-commerce skills, set LinkFox Skills.