dsh-surfing-plugin

Configuration

Explicit configuration wins over environment values. Override this plugin's row in $DSH_HOME/profiles/web/cordis.patch.yml:

- id: surfing-plugin
  config:
    searxng:
      url: https://search.example.com
      apiKeyEnv: MY_SEARXNG_KEY
      authHeader: X-API-Key
      authScheme: ''
      language: en
      categories: general,news
      safeSearch: 1
      timeRange: month
    crawl4ai:
      url: https://crawl.example.com
      apiKeyEnv: CRAWL4AI_API_TOKEN
      authHeader: Authorization
      authScheme: Bearer
      markdownMode: raw
      maxContentChars: 100000

Field	Environment or default	Meaning
searxng.url	SEARXNG_URL	Service root or /search endpoint
searxng.apiKey	none	Optional literal key
searxng.apiKeyEnv	SEARXNG_API_KEY	Environment variable containing the optional key
searxng.authHeader	Authorization	Authentication header
searxng.authScheme	Bearer	Authentication prefix; empty sends the key directly
searxng.language	server default	SearXNG language parameter
searxng.categories	server default	Comma-separated categories parameter
searxng.safeSearch	server default	0, 1, or 2
searxng.timeRange	none	day, month, or year
crawl4ai.url	CRAWL4AI_URL	Service root or /crawl endpoint
crawl4ai.apiKey	none	Optional literal key
crawl4ai.apiKeyEnv	CRAWL4AI_API_TOKEN	Environment variable containing the optional key
crawl4ai.authHeader	Authorization	Authentication header
crawl4ai.authScheme	Bearer	Authentication prefix; empty sends the key directly
crawl4ai.markdownMode	raw	Prefer raw, fit, or citations markdown
crawl4ai.maxContentChars	100000	Provider content cap before returning to DSH

A literal apiKey takes precedence over the environment variable named by apiKeyEnv. No authentication header is sent when no key is available.