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 | Default |
|---|---|---|---|
| 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 }; } }