spora-ai / spora-plugin-staan

v0.1.0 2026-09-28 16:26 UTC

Requires

• php: ^8.4.1
• spora-ai/spora-core: >=0.18.0 <2.0.0

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.94
• mockery/mockery: ^1.6
• pestphp/pest: ^4.0
• phpstan/phpstan: ^2.1
• phpstan/phpstan-mockery: ^2.0

MIT

Published on Packagist.org on 2026-09-28 16:51 UTC

README

Spora plugin: EU-hosted web search via Staan, the Qwant-powered search API. One tool, two operations — a fast ranked result list, or the same search enriched with relevance-scored excerpts of the actual page text.

The full reference (install, configuration, per-tool parameters, development) lives on the docs site:

docs.spora-ai.com/develop/plugins/reference/staan

At a glance

Tool (LLM wire name)	staan:search
Operations	search (default), enriched_search
Endpoint	POST https://api.staan.ai/v2/search/web
Auth	Authorization: Bearer <key> — 1,000 requests/month free
Markets	fr-fr (default), en-us, de-de
Rate limit	20 req/s; 10 results per page, max 4 pages (offset 0–30)

Both operations hit the same endpoint — Staan switches on enrichment by accepting extra_snippets in the payload, not by exposing a second URL.

Local development

composer install
./vendor/bin/pest                                    # 69 tests
./vendor/bin/phpstan analyse --no-progress           # level 5, must be 0 errors
./vendor/bin/php-cs-fixer fix --dry-run --diff       # same ruleset as spora-core

CI

.github/workflows/ci.yml runs Pest on PHP 8.4 + 8.5, PHPStan level 5, and php-cs-fixer dry-run. A coverage job produces the clover report and a sonar job uploads it to SonarCloud (project key spora-ai_spora-plugin-staan) so the new_coverage metric is measurable per PR. The sonar job needs the SONAR_TOKEN secret in the repo.

Publishing

Tag the release; the runtime reads the version from the git tag via Composer\InstalledVersions::getPrettyVersion(), so the tag is the single source of truth.

git tag v0.1.0 && git push --tags

API docs: https://docs.staan.ai/introduction · MIT