@m4ss/pi-staan-search

Web-search tool for Pi powered by Staan AI's European search API, with semantically enriched snippets for RAG-style usage, news search, and domain filtering

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.2.0
Published
Oct 28, 2026
Downloads
217/mo · 202/wk
Author
paolobarbolini
License
MIT
Types
extension
Size
27.6 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; web results always carry 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)
  • A deliberately small schema (query, market, type, offset) so smaller models don't misuse tuning knobs

Install

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

Usage

Requires STAAN_API_KEY:

export STAAN_API_KEY='your_staan_api_key'
staan_search("GDPR NIS2 Europe")
staan_search("AI Act", type="news")
staan_search("site:redis.io transactions")
staan_search("PostgreSQL performance", market="en-us")

API Key

Get a key at the Staan console.

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

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; market="fr-fr" filters reliably.

Related packages

License

MIT