Troubleshooting

Troubleshooting

Common Issues

"SORFTIME_MCP_KEY not set"

Run python3 scripts/install.py or set the env variable manually.

Tool returns "No relevant data"

1. Check parameter names first — same concept uses different names across tools
2. Try a different site, node_id, or ASIN
3. Some tools have limited data coverage (e.g., category_report_from_history, category_keywords)

Segfault / crash on Windows

Fixed in July 30 update. --one-shot path no longer imports mcp package. Update to latest main branch.

"Schema is X days old"

Run python3 tests/auto_sync.py to pull latest tool schemas from server.

Trend tools return weird array format

Shopee trend tools + Walmart trend/variation tools return [date, val, date, val...] flat arrays. Parse with: pairs = list(zip(data[::2], data[1::2]))

Keyword favorite tools return raw arrays

shopee_get_favorite_keyword_dict → ["dict_name", ...], shopee_get_favorite_keyword → ["keyword", ...]. These don't use the standard {doc, data} wrapper.

Parameter name mismatch

You're calling	With this param	But this tool needs
Amazon keyword tools	amz_site	keyword_support_site
product_customers_say	amz_site	site
similar_product_feature	asin	product_name
Shopee keyword tools	search_name	keyword

Getting Help

• Open an Issue
• Email: service@sorftime.com
• Full Skill Reference