# Add Search Engine

> Integrate a new LLM search provider into Mentha

- Skill: `diegosouzapw/add-search-engine` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add diegosouzapw/add-search-engine`
- Raw SKILL.md: https://api.skillmd.com/api/skills/diegosouzapw/add-search-engine/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: diegosouzapw (https://skillmd.com/u/diegosouzapw)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/diegosouzapw/add-search-engine

---


# Add Search Engine Skill

When the user requests to add a new AI search engine (e.g., "Integrate Claude 3", "Add Anthropic"), follow these steps:

## Steps

1. **Create Provider File**
   - Create `src/infrastructure/search/{provider-name}.provider.ts`
   - Import the `ISearchProvider` interface from `src/domain/search/types.ts`
   - Implement all required methods

2. **Provider Template**
   ```typescript
   import { ISearchProvider, SearchOptions, SearchResult } from '../../domain/search/types.js';
   import { env } from '../../config/index.js';

   export class {ProviderName}Provider implements ISearchProvider {
     private readonly apiKey: string;

     constructor() {
       this.apiKey = env.{PROVIDER}_API_KEY ?? '';
       if (!this.apiKey) {
         throw new Error('{PROVIDER}_API_KEY is required');
       }
     }

     async search(query: string, options?: SearchOptions): Promise<SearchResult> {
       // Implementation
     }
   }
   ```

3. **Update Factory**
   - Edit `src/infrastructure/search/factory.ts`
   - Add the new provider to the `createProvider` function
   - Add the provider enum value

4. **Update Environment**
   - Add `{PROVIDER}_API_KEY` to `.env.example`
   - Add to the env schema in `src/config/env.ts`

5. **Update Schema**
   - Add provider to the engines enum in controller schemas

6. **Test**
   - Run `npm run typecheck` to verify compilation
   - Create a basic integration test

## Validation Checklist

- [ ] Provider implements `ISearchProvider` interface
- [ ] Environment variable documented in `.env.example`
- [ ] Factory updated with new provider
- [ ] Controller enum includes new provider
- [ ] No TypeScript errors