feat: add photo URLs to maps_place_details via maxPhotos param

- Add optional maxPhotos param (0-10, default 0) to maps_place_details
- Default returns photo_count only (no extra tokens)
- When maxPhotos > 0, resolves actual photo URLs via getPhotoMedia API
- Add getPhotoUri method to NewPlacesService
- Update CLI exec to pass maxPhotos param
- Update tool description to document photo behavior

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

Author: cablate

src/cli.ts

@@ -124,7 +124,7 @@ async function execTool(toolName: string, params: any, apiKey: string): Promise<
     case "place-details":
     case "get_place_details":
     case "maps_place_details":
-      return searcher.getPlaceDetails(params.placeId);
+      return searcher.getPlaceDetails(params.placeId, params.maxPhotos || 0);
 
     case "directions":
     case "maps_directions":

src/services/NewPlacesService.ts

@@ -142,6 +142,20 @@ export class NewPlacesService {
     }
   }
 
+  async getPhotoUri(photoName: string, maxWidthPx: number = 800): Promise<string> {
+    try {
+      const [response] = await this.client.getPhotoMedia({
+        name: `${photoName}/media`,
+        maxWidthPx,
+        skipHttpRedirect: true,
+      });
+      return response.photoUri || "";
+    } catch (error: any) {
+      Logger.error("Error in getPhotoUri:", error);
+      throw new Error(`Failed to get photo URI: ${this.extractErrorMessage(error)}`);
+    }
+  }
+
   async getPlaceDetails(placeId: string) {
     try {
       const placeName = `places/${placeId}`;

src/services/PlacesSearcher.ts

@@ -194,10 +194,25 @@ export class PlacesSearcher {
     }
   }
 
-  async getPlaceDetails(placeId: string): Promise<PlaceDetailsResponse> {
+  async getPlaceDetails(placeId: string, maxPhotos: number = 0): Promise<PlaceDetailsResponse> {
     try {
       const details = await this.newPlacesService.getPlaceDetails(placeId);
 
+      // Resolve photo URLs if requested
+      let photos: Array<{ url: string; width: number; height: number }> | undefined;
+      if (maxPhotos > 0 && details.photos?.length > 0) {
+        const photosToFetch = details.photos.slice(0, maxPhotos);
+        photos = [];
+        for (const photo of photosToFetch) {
+          try {
+            const url = await this.newPlacesService.getPhotoUri(photo.photo_reference);
+            photos.push({ url, width: photo.width, height: photo.height });
+          } catch {
+            // Skip failed photos silently
+          }
+        }
+      }
+
       return {
         success: true,
         data: {
@@ -210,6 +225,8 @@ export class PlacesSearcher {
           phone: details.formatted_phone_number,
           website: details.website,
           price_level: details.price_level,
+          photo_count: details.photos?.length || 0,
+          ...(photos && photos.length > 0 ? { photos } : {}),
           reviews: details.reviews?.map((review: any) => ({
             rating: review.rating,
             text: review.text,

src/tools/maps/placeDetails.ts

@@ -4,20 +4,26 @@ import { getCurrentApiKey } from "../../utils/requestContext.js";
 
 const NAME = "maps_place_details";
 const DESCRIPTION =
-  "Get comprehensive details for a specific place using its Google Maps place_id. Use after search_nearby or maps_search_places to get full information including reviews, phone number, website, opening hours, and photos. Returns everything needed to evaluate or contact a business.";
+  "Get comprehensive details for a specific place using its Google Maps place_id. Use after search_nearby or maps_search_places to get full information including reviews, phone number, website, and opening hours. Set maxPhotos (1-10) to include photo URLs — omit or set to 0 for no photos (saves tokens).";
 
 const SCHEMA = {
   placeId: z.string().describe("Google Maps place ID"),
+  maxPhotos: z
+    .number()
+    .int()
+    .min(0)
+    .max(10)
+    .optional()
+    .describe("Number of photo URLs to include (0 = none, max 10). Omit to skip photos and save tokens."),
 };
 
 export type PlaceDetailsParams = z.infer<z.ZodObject<typeof SCHEMA>>;
 
 async function ACTION(params: any): Promise<{ content: any[]; isError?: boolean }> {
   try {
-    // Create a new PlacesSearcher instance with the current request's API key
     const apiKey = getCurrentApiKey();
     const placesSearcher = new PlacesSearcher(apiKey);
-    const result = await placesSearcher.getPlaceDetails(params.placeId);
+    const result = await placesSearcher.getPlaceDetails(params.placeId, params.maxPhotos || 0);
 
     if (!result.success) {
       return {