shieldapi.check_url
Read-onlyIdempotent
Check URLs for malware, phishing, and security threats using URLhaus database and heuristic analysis to identify potentially dangerous links.
Instructions
Check a URL for malware, phishing, and other threats. Uses URLhaus + heuristic analysis.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The URL to check (e.g. https://example.com) |
Implementation Reference
- src/index.ts:179-186 (handler)The handler for 'shieldapi.check_url' is dynamically registered in a loop that iterates over the `TOOLS` object. The handler invokes `callShieldApi` with the 'check-url' endpoint.
for (const [name, def] of Object.entries(TOOLS)) { server.tool( name, def.description, { [def.param]: z.string().describe(def.paramDesc) }, { ...readOnlyAnnotations, title: TOOL_TITLES[name] || name }, async (params) => formatResult(await callShieldApi(def.endpoint, params as Record<string, string>)) ); - src/index.ts:32-37 (registration)Definition of the 'shieldapi.check_url' tool configuration.
'shieldapi.check_url': { description: 'Check a URL for malware, phishing, and other threats. Uses URLhaus + heuristic analysis.', param: 'url', paramDesc: 'The URL to check (e.g. https://example.com)', endpoint: 'check-url', },