docs: update skill docs and READMEs for maxPhotos param

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: cablate

README.md

@@ -65,7 +65,7 @@ Special thanks to [@junyinnnn](https://github.com/junyinnnn) for helping add sup
 |------|-------------|
 | `maps_search_nearby` | Find places near a location by type (restaurant, cafe, hotel, etc.). Supports filtering by radius, rating, and open status. |
 | `maps_search_places` | Free-text place search (e.g., "sushi restaurants in Tokyo"). Supports location bias, rating, open-now filters. |
-| `maps_place_details` | Get full details for a place by its place_id — reviews, phone, website, hours, photos. |
+| `maps_place_details` | Get full details for a place by its place_id — reviews, phone, website, hours. Optional `maxPhotos` param returns photo URLs. |
 | `maps_geocode` | Convert an address or landmark name into GPS coordinates. |
 | `maps_reverse_geocode` | Convert GPS coordinates into a street address. |
 | `maps_distance_matrix` | Calculate travel distances and times between multiple origins and destinations. |

README.zh-TW.md

@@ -65,7 +65,7 @@ npx @cablate/mcp-google-map --port 3000 --apikey "YOUR_API_KEY"
 |------|------|
 | `maps_search_nearby` | 依類型搜尋附近地點（餐廳、咖啡廳、飯店等），支援半徑、評分、營業中篩選 |
 | `maps_search_places` | 自然語言地點搜尋（如「東京拉麵」），支援位置偏好、評分、營業中篩選 |
-| `maps_place_details` | 以 place_id 取得地點完整資訊 — 評論、電話、網站、營業時間、照片 |
+| `maps_place_details` | 以 place_id 取得地點完整資訊 — 評論、電話、網站、營業時間。可選 `maxPhotos` 參數取得照片 URL。 |
 | `maps_geocode` | 將地址或地標名稱轉換為 GPS 座標 |
 | `maps_reverse_geocode` | 將 GPS 座標轉換為街道地址 |
 | `maps_distance_matrix` | 計算多個起點與終點間的旅行距離和時間 |

skills/google-maps/SKILL.md

@@ -44,7 +44,7 @@ Without this Skill, the agent can only guess or refuse when asked "how do I get
 | `maps_reverse_geocode` | Have coordinates, need an address | "What's at 35.65, 139.74?" |
 | `maps_search_nearby` | Know a location, find nearby places by type | "Coffee shops near my hotel" |
 | `maps_search_places` | Natural language place search | "Best ramen in Tokyo" |
-| `maps_place_details` | Have a place_id, need full info | "Opening hours and reviews for this restaurant?" |
+| `maps_place_details` | Have a place_id, need full info (+ optional photo URLs via `maxPhotos`) | "Opening hours and reviews for this restaurant?" |
 | `maps_batch_geocode` | Geocode multiple addresses at once (max 50) | "Get coordinates for all these offices" |
 
 ### Routing & Distance

skills/google-maps/references/tools-api.md

@@ -122,15 +122,17 @@ Response: `{ success, data: [{ name, place_id, address, location, rating, total_
 
 ## maps_place_details
 
-Get full details for a place by its place_id (from search results). Returns reviews, phone, website, hours, photos.
+Get full details for a place by its place_id (from search results). Returns reviews, phone, website, hours. Set `maxPhotos` to include photo URLs (default: 0 = no photos, saves tokens).
 
 ```bash
 exec maps_place_details '{"placeId": "ChIJCewJkL2LGGAR3Qmk0vCTGkg"}'
+exec maps_place_details '{"placeId": "ChIJCewJkL2LGGAR3Qmk0vCTGkg", "maxPhotos": 3}'
 ```
 
 | Param | Type | Required | Description |
 |-------|------|----------|-------------|
 | placeId | string | yes | Google Maps place ID (from search results) |
+| maxPhotos | number | no | Number of photo URLs to include (0-10, default 0). Always returns `photo_count`. |
 
 ---