soliguide-api

Build and run authenticated Soliguide API searches for places and services.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/solinumasso/solikit --skill soliguide-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: soliguide-api
Source: https://github.com/solinumasso/solikit/tree/main/.claude/skills/soliguide-api
Command: npx skills add https://github.com/solinumasso/solikit --skill soliguide-api

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you build and execute Soliguide API searches for retrieving places and services without guessing parameters, while validating authentication and geographic scope first.

Core Features & Use Cases

  • Token-first guided tunnel: verifies the chosen country token (including a JWT decode and /users/me or fallback checks) before you search.
  • Geography + categories search builder: guides selection of country, geographic zone (pays/region/département/ville/position), and Soliguide category slugs (single or multiple).
  • Operational execution with correct payload shape: constructs POST /new-search/{lang} requests with the right Authorization header format (JWT) and supports pagination to retrieve full result sets.
  • Typical use cases: when a project needs to fetch Soliguide fiches (lieux, services solidaires) or when a user asks to “call the Soliguide API” or “retrieve Soliguide places”.

Quick Start

Ask the AI to run the Soliguide API search tunnel by choosing the country fr (or es/ad) and then providing the zone and the category (or categories) you want to retrieve.

Frequently Asked Questions about soliguide-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I retrieve places and services from the Soliguide API using geographic filtering?

To retrieve Soliguide places and services, you build a query by selecting a country, defining a geographic scope like a region or city, and specifying category slugs to filter the search results. Pagination is supported to retrieve full result sets.

What JWT token validation is required to search the Soliguide API?

Soliguide API searches require JWT token validation via the /users/me endpoint, with a fallback to a minimal /new-search test. The token must be passed in the Authorization header of your POST request to authenticate and execute the search.

Can I fetch Soliguide fiches for multiple category slugs in a single API request?

Yes, you can retrieve Soliguide fiches for multiple category slugs in a single API search. The query builder guides the selection of single or multiple categories alongside your chosen country and geographic zone to construct the correct payload.

Do I need to validate my Soliguide country token before running an API search?

Yes, a token-first guided tunnel verifies your chosen country token before you search. It performs a JWT decode and checks authentication against /users/me to ensure your token is valid before executing the query.

What is the correct payload shape for a Soliguide API new-search request?

The correct payload shape for a Soliguide API search is a POST request sent to /new-search/{lang} with the JWT formatted correctly in the Authorization header. It includes the country, geographic zone, category slugs, and pagination parameters.

Why does my Soliguide API search return an authentication error?

Soliguide API search authentication errors occur when the JWT token is missing, invalid, or incorrectly formatted in the Authorization header. The skill enforces token validation through /users/me with a fallback test to prevent these errors.