Metadata-Version: 2.3
Name: mizutsune-taobaosearch-mcp-server
Version: 0.1.2
Summary: 这是一个淘宝的自动搜索并筛选价格区间的mcp-server，用户可以输入想要搜索的物品，并指定价格范围，让其返回n个商品的链接和图片以及分析。本意是做一个自动搜索电脑整机并且返回对比分析配置和价格，得出性价比的mcp，但是由于拿到url之后，每个淘宝店电脑配置的位置完全不一样，就退化为搜索商品并返回了，作为练手，不算很好用
Author: Mizutsune
Author-email: Mizutsune <872595975@qq.com>
Requires-Dist: asyncio>=4.0.0
Requires-Dist: fastmcp>=2.14.1
Requires-Dist: mcp[cli]>=1.25.0
Requires-Dist: playwright>=1.57.0
Requires-Dist: uuid>=1.30
Requires-Python: >=3.13
Description-Content-Type: text/markdown

# 商品搜索助手使用说明

欢迎使用商品搜索助手！本工具帮助您在淘宝上搜索特定商品，并提供商品的基本信息和截图。请根据以下说明进行操作。

## 使用说明
一定要输入预先提示词！！！才会更好的执行！！！
您将需要输入以下信息，以便助手能够为您执行所需的商品搜索：

1. **搜索关键词**：例如 “电脑主机”
2. **价格区间**：如 “5000” 元 到 “6000” 元
3. **需要获取的商品数量**：如 “3” 个

## 操作步骤

1. **命令行启动chrome浏览器**：
    - 你需要先指定窗口（命令行输入）："C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222 --user-data-dir="C:\chrome_debug_temp"

2. **手动打开淘宝并登录**：登录淘宝

3. **开始提问**：例如：帮我上淘宝搜索”圣诞礼物“，价格区间为100-300元，帮我找出3个商品并返回给我

## 函数内部执行逻辑
1. **调用 `search_and_filter`**：
   - 输入您想要搜索的关键词。
   - 悬停鼠标到“区间”按钮以显示筛选价格框。

2. **调用 `fill_price_filter`**：
   - 输入您希望筛选的价格区间。例如，从最低价 “5000” 元到最高价 “6000” 元。

3. **调用 `get_top_product_links`**：
   - 获取您指定数量的商品链接，例如获取 “3” 个商品链接。

4. **调用 `capture_specs_area`**：
   - 对每个商品详情页进行截图，并返回给用户查看。


助手将执行以下操作：

1. **搜索关键词**：
   - 调用 `search_and_filter("圣诞礼物")`，悬停到“区间”按钮。

2. **筛选价格区间**：
   - 调用 `fill_price_filter(100, 300)`。

3. **获取商品链接**：
   - 调用 `get_top_product_links(3)`。

4. **截图商品详情**：
   - 调用 `capture_specs_area()`。

## 最终输出格式

助手将为您提供以下格式的输出列表：

```plaintext
1. 商品标题：XXXX
   价格：XXXX元
   链接：[商品链接]
   可查看截图：[点击这里]

2. 商品标题：XXXX
   价格：XXXX元
   链接：[商品链接]
   可查看截图：[点击这里]

3. 商品标题：XXXX
   价格：XXXX元
   链接：[商品链接]
   可查看截图：[点击这里]