@m4ss/pi-staan-search

Staan AI European search extension for pi-coding-agent

Packages

Package details

extension

Install @m4ss/pi-staan-search from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@m4ss/pi-staan-search
Package
@m4ss/pi-staan-search
Version
0.1.0
Published
Jul 6, 2026
Downloads
160/mo · 14/wk
Author
paolobarbolini
License
MIT
Types
extension
Size
31.1 KB
Dependencies
0 dependencies · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@m4ss/pi-staan-search

We use Staan's Web Search for AI API because the semantic snippets work well for our RAG-style usage. This extension registers the staan_search tool so the model can search the web and get enriched result chunks.

Features

  • Web and news search with semantic enrichment (extra snippets for RAG-style usage)
  • Domain filters via site:domain or -domain.tld in the query
  • Market selection for language/region-aware results (default: fr-fr)
  • Full-content requests that ask Staan for page bodies and reranking

Install

pi install npm:@m4ss/pi-staan-search

Usage

Set your API key:

export STAAN_API_KEY='your_staan_api_key'

The LLM will automatically see staan_search as an available tool. Example calls:

  • staan_search("GDPR NIS2 Europe") – Web Search for AI using the default fr-fr market
  • staan_search("AI Act", type="news") – plain news search
  • staan_search("site:redis.io transactions") – narrow to a specific domain
  • staan_search("PostgreSQL performance", minScore=0.2, maxSnippets=5) – RAG-ready chunks

API Key

Get a key at staan.ai → Developer Console.

  • Free tier: 1,000 requests/month
  • Web Search: €1 / 1,000 requests
  • Web Search for AI: €2 / 1,000 requests

Routing, privacy, and fallback behavior

  • fr-fr (default) prefers the European/Staan-backed route.
  • en-us may use fallback/non-EU infrastructure and domain filters (site:) may not work on fallback-routed markets.
  • For compliance-sensitive use, verify Staan's DPA/subprocessors and request EU-only routing.

Limits

  • Queries are capped at 400 characters (API limit). A note is added if truncated.
  • Domain filters via site: syntax may not work when Staan routes through its fallback provider; use market="fr-fr" for reliable filtering.
  • Pagination supports offsets of 0, 10, 20, or 30 (10 results per page).
  • Web searches use semantic enrichment by default. Set extraSnippets=false for plain Web Search.
  • All API calls use a 10s timeout.

Related packages

License

MIT