instagram-photo-find

查找任何目的地或地点的高质量 Instagram 照片。通过网络搜索搜索 Instagram 帖子，下载候选图像，对它们的质量和标志性进行视觉评分，并返回与源 URL 的最佳匹配。当您需要来自 Instagram 的旅行/目的地照片、某个地点的英雄图像或任何地点或景点的 Instagram 帖子图像时使用。

# Instagram Photo Find

Find the best Instagram photo for a given destination or place name.

## Workflow

### Step 1 — Search for Instagram post URLs

Search Brave for: `site:instagram.com/p/ {destination} popular photo`

- Request 10 results
- If the destination is a specific attraction/restaurant, use its name directly (e.g. `site:instagram.com/p/ "Barton Springs" Austin`)

### Step 2 — Filter candidates by title

From search results, pick the top 5-6 candidates based on titles that suggest scenic/visual content:

**Prefer titles with:**
- Visual/emotional language ("beautiful", "colors", "stunning", "golden hour", "aerial", "skyline")
- Specific landmark names
- Travel/photography language ("travel", "explore", "photography")

**Skip titles that suggest:**
- Brand/corporate posts (Nike, concerts, conferences)
- Personal diary posts ("photo dump", "my trip")
- Celebrity/influencer selfies
- Non-photo content (events, announcements)

### Step 3 — Download images

For each candidate, extract the image via:

```
https://www.instagram.com/p/{shortcode}/media/?size=l
```

- Use `curl -s -L` (follows the 302 redirect to CDN)
- Skip any that return non-200 or < 10KB (likely broken/removed)
- Save to `/tmp/` with descriptive names

### Step 4 — Vision-score each image

Run each downloaded image through the vision model with this prompt:

> Describe briefly. Rate 1-10 as a hero destination photo for {destination} (iconic, scenic, represents the place well). Description + score only.

### Step 5 — Return results

Return images ranked by score. For each result, provide:
- Score and brief description
- Instagram post URL (`instagram.com/p/{shortcode}/`)
- Local file path

## Parameters

- **destination** (required): Place name (e.g. "Mexico City", "Taormina Italy", "Barton Springs Austin")
- **count** (optional, default 2): How many top results to return
- **search_variant** (optional): Additional search terms to append (e.g. "photography", "travel guide")

## Tips

- For broad destinations (cities/countries), the generic search works well
- For specific attractions, quote the name: `"Palacio de Bellas Artes"`
- If first search yields low scores (< 6), retry with landmark-specific queries
- The `/media/?size=l` endpoint requires no authentication
- Carousel posts return only the first image
- Video posts may return a thumbnail

---

## 中文说明

# Instagram 照片查找

为给定的目的地或地点名称查找最佳的 Instagram 照片。

## 工作流程

### 第 1 步 — 搜索 Instagram 帖子 URL

在 Brave 上搜索：`site:instagram.com/p/ {destination} popular photo`

- 请求 10 条结果
- 如果目的地是某个特定景点/餐厅，直接使用其名称（例如 `site:instagram.com/p/ "Barton Springs" Austin`）

### 第 2 步 — 按标题筛选候选项

从搜索结果中，根据标题所暗示的风景/视觉内容，挑选出前 5-6 个候选项：

**优先选择包含以下内容的标题：**
- 视觉/情感性语言（"beautiful"、"colors"、"stunning"、"golden hour"、"aerial"、"skyline"）
- 具体的地标名称
- 旅行/摄影类语言（"travel"、"explore"、"photography"）

**跳过暗示以下内容的标题：**
- 品牌/企业类帖子（Nike、演唱会、会议）
- 个人日记类帖子（"photo dump"、"my trip"）
- 名人/网红自拍
- 非照片内容（活动、公告）

### 第 3 步 — 下载图像

对每个候选项，通过以下方式提取图像：

```
https://www.instagram.com/p/{shortcode}/media/?size=l
```

- 使用 `curl -s -L`（会跟随指向 CDN 的 302 重定向）
- 跳过任何返回非 200 状态或小于 10KB 的项（可能已损坏/被删除）
- 以描述性名称保存到 `/tmp/`

### 第 4 步 — 对每张图像进行视觉评分

使用以下提示词，让视觉模型处理每张下载的图像：

> Describe briefly. Rate 1-10 as a hero destination photo for {destination} (iconic, scenic, represents the place well). Description + score only.

### 第 5 步 — 返回结果

按评分对图像进行排序后返回。对每个结果，提供：
- 评分和简要描述
- Instagram 帖子 URL（`instagram.com/p/{shortcode}/`）
- 本地文件路径

## 参数

- **destination**（必填）：地点名称（例如 "Mexico City"、"Taormina Italy"、"Barton Springs Austin"）
- **count**（可选，默认 2）：返回多少个排名靠前的结果
- **search_variant**（可选）：追加的额外搜索词（例如 "photography"、"travel guide"）

## 提示

- 对于宽泛的目的地（城市/国家），通用搜索效果良好
- 对于特定景点，请用引号括起名称：`"Palacio de Bellas Artes"`
- 如果首次搜索得分较低（< 6），请用针对地标的查询重试
- `/media/?size=l` 端点无需身份验证
- 轮播帖子仅返回第一张图像
- 视频帖子可能返回缩略图