linkfox-ehunt-etsy-category-search

EHunt Etsy category search (_ehunt_etsyCategorySearch）

When the LinkFox "Third-Party Data Service" MCP is available, call by tool name _ehunt_etsyCategorySearch (MCP display name:Etsy Category Query, subject to the tool metadata issued in the current environment). Data comes from MCP library local search。

Prerequisites

The library must already contain the full categories written by _ehunt_syncEtsyCategory (MCP display name:Etsy Category Sync). If there is no data or the results are empty, complete the sync first before searching.

Key Points

• Required：keyword(substring matching on category name, category id,parentIds）。
• Pagination：page starts from 1;pageSize defaults to 50, maximum 200.
• The returned id can be used as the category identifier for inputs such as _ehunt_productQuery / shop-side category etc. (as long as it is consistent with the specific tool schema).

Script (optional)

Command-line debugging:python scripts/ehunt_etsy_category_search.py '<JSON>'(requires LINKFOXAGENT_API_KEY). See the end of references/api.md .

Reference

For the input/output parameter table, see references/api.md。

Handling Large Responses

To avoid overflowing the agent context, persist the response to disk and extract only the fields you need:

python scripts/response_io.py run --script scripts/ehunt_etsy_category_search.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

Pick --out-dir outside any git working tree (e.g. /tmp/... on Unix, %TEMP%/... on Windows). Persisted responses may contain PII, pricing, or auth-sensitive data — do not commit them. Files are not auto-deleted; clean up when the task is done.

run writes the full response to a file and emits only a schema preview + file path. read projects specific fields, with --limit/--offset for slicing and --format json|jsonl|csv|table for output.

When to prefer this pattern — apply your judgment based on the response characteristics, e.g.:

• High field count per record, or fields you don't need
• Batch/paginated results (multiple items per call)
• Long-text fields (descriptions, reviews, HTML, time series)
• Output reused across later steps rather than consumed immediately

For small, single-use responses, calling the main script directly is fine.

⚠️ The preview is a truncated schema + sample, not the full data. Any field-level decision must read from the persisted file via read.