search_google_maps_reviews

Retrieve Google Maps reviews for locations using place IDs, with options to filter by rating, sort results, and control language settings.

Input Schema

TableJSON Schema

Name	Required	Description
`place_id`	No	地点ID
`data_id`	No	数据ID
`topic_id`	No	主题ID
`next_page_token`	No	下一页令牌
`sort_by`	No	排序方式
`rating`	No	评分
`hl`	No	语言
`gl`	No	地理位置
`reviews_limit`	No	评论数量限制

Implementation Reference

src/index.js:248-280 (handler)

The main handler function for the search_google_maps_reviews tool. It validates required parameters (place_id or data_id), adds optional parameters, calls the makeSearchapiRequest helper to fetch data from searchapi.io's Google Maps reviews API, and returns the JSON-formatted result.

async (args) => {
  const params = {
    engine: 'google_maps_reviews'
  };
  
  // 检查必填参数
  if (args.place_id) {
    params.place_id = args.place_id;
  } else if (args.data_id) {
    params.data_id = args.data_id;
  } else {
    return {
      content: [{ type: 'text', text: JSON.stringify({ error: '必须提供place_id或data_id参数' }) }],
      isError: true
    };
  }
  
  // 添加可选参数
  const optionalParams = [
    'topic_id', 'next_page_token', 'sort_by', 'rating', 'hl', 'gl', 'reviews_limit'
  ];
  
  for (const key of optionalParams) {
    if (args[key] !== undefined) {
      params[key] = args[key];
    }
  }
  
  const result = await makeSearchapiRequest(params);
  return {
    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }]
  };
}

src/index.js:237-247 (schema)

Zod input schema for the search_google_maps_reviews tool, defining optional parameters like place_id, data_id, sorting, filtering by rating, language, etc.

{
  place_id: z.string().optional().describe('地点ID'),
  data_id: z.string().optional().describe('数据ID'),
  topic_id: z.string().optional().describe('主题ID'),
  next_page_token: z.string().optional().describe('下一页令牌'),
  sort_by: z.string().optional().describe('排序方式'),
  rating: z.string().optional().describe('评分'),
  hl: z.string().optional().describe('语言'),
  gl: z.string().optional().describe('地理位置'),
  reviews_limit: z.string().optional().describe('评论数量限制')
},

src/index.js:234-281 (registration)

Registration of the search_google_maps_reviews tool via server.tool(), which includes the inline schema and handler function definitions.

// 实现工具函数：搜索Google地图评论
server.tool(
  'search_google_maps_reviews',
  {
    place_id: z.string().optional().describe('地点ID'),
    data_id: z.string().optional().describe('数据ID'),
    topic_id: z.string().optional().describe('主题ID'),
    next_page_token: z.string().optional().describe('下一页令牌'),
    sort_by: z.string().optional().describe('排序方式'),
    rating: z.string().optional().describe('评分'),
    hl: z.string().optional().describe('语言'),
    gl: z.string().optional().describe('地理位置'),
    reviews_limit: z.string().optional().describe('评论数量限制')
  },
  async (args) => {
    const params = {
      engine: 'google_maps_reviews'
    };
    
    // 检查必填参数
    if (args.place_id) {
      params.place_id = args.place_id;
    } else if (args.data_id) {
      params.data_id = args.data_id;
    } else {
      return {
        content: [{ type: 'text', text: JSON.stringify({ error: '必须提供place_id或data_id参数' }) }],
        isError: true
      };
    }
    
    // 添加可选参数
    const optionalParams = [
      'topic_id', 'next_page_token', 'sort_by', 'rating', 'hl', 'gl', 'reviews_limit'
    ];
    
    for (const key of optionalParams) {
      if (args[key] !== undefined) {
        params[key] = args[key];
      }
    }
    
    const result = await makeSearchapiRequest(params);
    return {
      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }]
    };
  }
);

src/index.js:29-57 (helper)

Shared helper function that sends requests to the searchapi.io API endpoint, appends the API key, handles timeouts and errors, and is called by the tool handler.

async function makeSearchapiRequest(params) {
  // 确保API Key被添加到参数中
  params.api_key = SEARCHAPI_API_KEY;
  
  try {
    const response = await axios.get(SEARCHAPI_URL, {
      params,
      timeout: 30000 // 30秒超时
    });
    return response.data;
  } catch (error) {
    let errorDetail = null;
    
    if (error.response) {
      try {
        errorDetail = error.response.data;
      } catch (e) {
        errorDetail = error.response.statusText;
      }
    }
    
    const errorMessage = `调用searchapi.io时出错: ${error.message}`;
    if (errorDetail) {
      return { error: `${errorMessage}, 详情: ${JSON.stringify(errorDetail)}` };
    }
    
    return { error: errorMessage };
  }
}

SearchAPI MCP Server