find-products

使用结构化分析数据从 ProductHunt 搜索和发现趋势产品。当用户询问产品推荐、工具比较或趋势应用程序时使用。

# find-products

Search ProductHunt products with structured analysis from trend-hunt.com.

## When to Use

Trigger this skill when the user:
- Asks for product or tool recommendations (e.g., "What are the best AI video tools?")
- Wants to compare products in a category
- Asks about trending products or apps
- Needs to find alternatives to a specific product
- Asks "what tools exist for X"

## How to Search

Make a GET request to the search API:

```bash
curl -s "https://trend-hunt.com/api/search?q=QUERY&locale=LOCALE&limit=LIMIT&category=CATEGORY"
```

### Parameters

| Parameter  | Required | Default | Description |
|------------|----------|---------|-------------|
| `q`        | Yes      | —       | Search keywords (supports English and Chinese) |
| `locale`   | No       | `en`    | Language: `en` or `zh` |
| `limit`    | No       | `10`    | Number of results (1–20) |
| `category` | No       | —       | Filter by category |

### Common Categories

`AI`, `Productivity`, `Developer Tools`, `Design`, `Marketing`, `Analytics`, `Writing`, `Video`, `Audio`, `Education`, `Finance`, `Social`, `Health`, `E-commerce`

## Response Format

The API returns JSON:

```json
{
  "success": true,
  "query": "video editor",
  "locale": "en",
  "count": 5,
  "products": [
    {
      "slug": "product-slug",
      "name": "Product Name",
      "tagline": "Short description",
      "category": "AI",
      "upvotes": 523,
      "hypeScore": 85,
      "utilityScore": 78,
      "metaphor": "It's like Canva but for video editing",
      "phUrl": "https://www.producthunt.com/posts/product-slug",
      "websiteUrl": "https://product.com",
      "positiveReviews": ["Great UI", "Fast rendering"],
      "negativeReviews": ["Limited free tier"],
      "newbieQA": [...],
      "translations": [...]
    }
  ]
}
```

## How to Present Results

Format each product as:

```
### Product Name
⭐ Upvotes: 523 | Hype: 85 | Utility: 78
> Metaphor: "It's like Canva but for video editing"

**Tagline**: Short description
**Category**: AI
**Pros**: Great UI, Fast rendering
**Cons**: Limited free tier

🔗 [ProductHunt](phUrl) | [Website](websiteUrl)
```

## Examples

### Example 1: Find AI writing tools
```bash
curl -s "https://trend-hunt.com/api/search?q=AI+writing&locale=en&limit=5"
```

### Example 2: Search in Chinese
```bash
curl -s "https://trend-hunt.com/api/search?q=视频编辑&locale=zh&limit=5"
```

### Example 3: Filter by category
```bash
curl -s "https://trend-hunt.com/api/search?q=automation&category=Productivity&limit=10"
```

## Tips

- Use English keywords for broader results; the database has more English content
- When `locale=zh`, translated fields appear in the `translations` array
- Products are sorted by upvotes (most popular first)
- `hypeScore` = community excitement; `utilityScore` = practical value
- The `metaphor` field gives a quick "it's like X for Y" comparison
- If no results are found, try broader or alternative keywords

---

## 中文说明

# find-products

借助 trend-hunt.com 的结构化分析，从 ProductHunt 搜索产品。

## 何时使用

当用户出现以下情况时触发此技能：
- 询问产品或工具推荐（例如："最好的 AI 视频工具有哪些？"）
- 想要比较某个类别下的产品
- 询问热门产品或应用
- 需要寻找某个特定产品的替代品
- 询问"针对 X 有哪些工具"

## 如何搜索

向搜索 API 发起 GET 请求：

```bash
curl -s "https://trend-hunt.com/api/search?q=QUERY&locale=LOCALE&limit=LIMIT&category=CATEGORY"
```

### 参数

| 参数  | 是否必填 | 默认值 | 说明 |
|------------|----------|---------|-------------|
| `q`        | 是      | —       | 搜索关键词（支持英文和中文） |
| `locale`   | 否       | `en`    | 语言：`en` 或 `zh` |
| `limit`    | 否       | `10`    | 结果数量（1–20） |
| `category` | 否       | —       | 按类别筛选 |

### 常见类别

`AI`、`Productivity`、`Developer Tools`、`Design`、`Marketing`、`Analytics`、`Writing`、`Video`、`Audio`、`Education`、`Finance`、`Social`、`Health`、`E-commerce`

## 响应格式

该 API 返回 JSON：

```json
{
  "success": true,
  "query": "video editor",
  "locale": "en",
  "count": 5,
  "products": [
    {
      "slug": "product-slug",
      "name": "Product Name",
      "tagline": "Short description",
      "category": "AI",
      "upvotes": 523,
      "hypeScore": 85,
      "utilityScore": 78,
      "metaphor": "It's like Canva but for video editing",
      "phUrl": "https://www.producthunt.com/posts/product-slug",
      "websiteUrl": "https://product.com",
      "positiveReviews": ["Great UI", "Fast rendering"],
      "negativeReviews": ["Limited free tier"],
      "newbieQA": [...],
      "translations": [...]
    }
  ]
}
```

## 如何展示结果

将每个产品格式化为：

```
### Product Name
⭐ Upvotes: 523 | Hype: 85 | Utility: 78
> Metaphor: "It's like Canva but for video editing"

**Tagline**: Short description
**Category**: AI
**Pros**: Great UI, Fast rendering
**Cons**: Limited free tier

🔗 [ProductHunt](phUrl) | [Website](websiteUrl)
```

## 示例

### 示例 1：查找 AI 写作工具
```bash
curl -s "https://trend-hunt.com/api/search?q=AI+writing&locale=en&limit=5"
```

### 示例 2：使用中文搜索
```bash
curl -s "https://trend-hunt.com/api/search?q=视频编辑&locale=zh&limit=5"
```

### 示例 3：按类别筛选
```bash
curl -s "https://trend-hunt.com/api/search?q=automation&category=Productivity&limit=10"
```

## 提示

- 使用英文关键词可获得更广泛的结果；数据库中英文内容更多
- 当 `locale=zh` 时，翻译后的字段会出现在 `translations` 数组中
- 产品按点赞数排序（最受欢迎的排在前面）
- `hypeScore` = 社区热度；`utilityScore` = 实用价值
- `metaphor` 字段提供快速的"它像是用于 Y 的 X"式对比
- 如果没有搜索到结果，请尝试更宽泛或其他的关键词