search_school_units_by_name
Find Swedish schools by name or partial name patterns to identify specific educational institutions and school groups using official Skolverket data.
Instructions
Sök skolenheter efter namn.
ANVÄNDNINGSFALL:
Hitta specifik skola
Filtrera efter namnmönster
Identifiera skolgrupper
RETURNERAR: Skolenheter som matchar söktermen (delmatchning).
TIPS: Fungerar med partiella namn.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| limit | No |
Implementation Reference
- src/tools/school-units/search.ts:144-177 (handler)Main execution logic for the 'search_school_units_by_name' tool. Fetches school units by name using the API client, applies optional limit, formats response as JSON text block.export async function searchSchoolUnitsByName(params: { name: string; limit?: number; }) { try { const units = await schoolUnitsApi.searchSchoolUnitsByName(params.name); // Begränsa antal resultat const limitedUnits = params.limit ? units.slice(0, params.limit) : units.slice(0, 50); return { content: [ { type: 'text' as const, text: JSON.stringify({ searchTerm: params.name, totalFound: units.length, showing: limitedUnits.length, schoolUnits: limitedUnits }, null, 2) } ] }; } catch (error) { return { content: [ { type: 'text' as const, text: `Fel vid sökning av skolenheter efter namn: ${error instanceof Error ? error.message : String(error)}` } ], isError: true }; }
- Input schema definition using Zod for the searchSchoolUnitsByName tool parameters.export const searchSchoolUnitsByNameSchema = { name: z.string().describe('Namn eller del av namn att söka efter'), limit: z.number().optional().default(50).describe('Maximalt antal resultat att returnera') };
- src/http-server.ts:75-75 (registration)Registration of the tool handler in the tools registry object used by the HTTP server.search_school_units_by_name: searchSchoolUnitsByName,
- src/http-server.ts:27-27 (registration)Import statement bringing in the searchSchoolUnitsByName handler function.import { searchSchoolUnits, getSchoolUnitDetails, getSchoolUnitsByStatus, searchSchoolUnitsByName } from './tools/school-units/search.js';
- src/api/school-units-client.ts:86-88 (helper)API client method that performs the actual search by delegating to the general searchSchoolUnits with name filter.async searchSchoolUnitsByName(name: string): Promise<any[]> { return this.searchSchoolUnits({ name }); }