batch_url
Read-onlyIdempotent
Analyze multiple URLs simultaneously for security threats by checking against 10M+ intelligence records from FTC, FCC, URLhaus, and other sources. Process up to 100 URLs in one request to identify risk scores and potential scams.
Instructions
Check multiple URLs in a single request (max 100). Each URL is analyzed individually with the same checks as check_url. Returns results array with per-item risk scores and a summary.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| urls | Yes | Array of URLs to check (1-100) | |
| force_refresh | No | Force fresh lookups, bypassing cache (default: false) |
Implementation Reference
- src/index.ts:331-354 (handler)Definition and implementation of the 'batch_url' tool. It takes an array of URLs and performs a batch lookup via the API.
// 8. batch_url server.tool( 'batch_url', 'Check multiple URLs in a single request (max 100). Each URL is analyzed individually with the same checks as check_url. Returns results array with per-item risk scores and a summary.', { urls: z.array(z.string()).min(1).max(100).describe('Array of URLs to check (1-100)'), force_refresh: z.boolean().optional().describe('Force fresh lookups, bypassing cache (default: false)'), }, { title: 'Batch URL Lookup', readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true, }, async ({ urls, force_refresh }) => { try { const data = await apiPost('/api/v1/batch/url', { urls, force_refresh }); return jsonResult(data); } catch (err) { return errorResult(err instanceof Error ? err.message : 'Batch URL lookup failed'); } }, );