[Index de la documentation](https://prescriptio.fr/docs/llms.txt)

# Chercher des projets

L'outil projets_rechercher de Prescriptio cherche les projets du bâti reconstitués par Prescriptio, avec les filtres des vues Liste, Carte et Acteurs : département, stade, source, rôle, fraîcheur.

### Squelette d'appel, généré depuis le schéma

**MCP (JSON-RPC)**

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "projets_rechercher"
  }
}
```

**HTTP (curl)**

```bash
curl -sS https://prescriptio.fr/api/mcp \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"projets_rechercher"}}'
```

### Forme de la réponse, générée depuis le schéma

```json
{
  "action": "<texte>",
  "download_url": "<texte>",
  "fields": {},
  "files": [
    {}
  ],
  "ok": false,
  "page": 0,
  "pages_total": 0,
  "quota": {},
  "texte": "<texte>"
}
```

## Paramètres

| Nom | Type | Requis | Description |
|---|---|---|---|
| `query_string` | texte | — | Filtres de l’URL /projets, par exemple dept=69&dept=38&stade=preparation&fresh=90&page=2. Ajouter vue=acteurs pour les agrégats d’acteurs. (max. caractères 16000) |

## Quand l'utiliser

Fournir query_string depuis l’URL de la sélection (sans le ?). Paramètrès répétés pour dept, insee (codes exacts), stade, segment, source, role. fresh=0 pour tout l’historique, sinon 365 jours par défaut. vue=acteurs agrège les intervenants sans double compter les logements. acteur=ma-base restreint aux projets où une entreprise de la base de l’appelant intervient. Les informations absentes restent inconnues. Une attribution ne prouve pas le démarrage du chantier. Réutiliser la query retournée pour paginer. Ma base est limitée à l’organisation de l’appelant.

**Prompt prêt à coller : Le prompt qui le déclenche**

```text
Avec Prescriptio, montre les projets du bâti du Rhône apparus ces 90 derniers jours, avec leurs intervenants.
```

Outil : `projets_rechercher` · Portée : `mcp:read`, lecture seule · Coût : 1 appel, aucune unité de dossier · Limite : 100 appels par 24 heures en compte gratuit, 5 000 abonné

## En bref

| | |
|---|---|
| Effets | lecture seule |
| Portée OAuth | `mcp:read` |
| Conditions d’accès | Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas. |
| Données lues | la donnée publique du bâti — aucune coordonnée personnelle n'est jamais renvoyée |
| Distribution | MCP historique |
| En REST | aucune opération : il s'appelle par le connecteur MCP |

## Réponse

Le résultat arrive dans `content[0].text` (le JSON sérialisé) et dans `structuredContent` (le même objet). L'exemple donne les **types**, jamais des valeurs réelles. Un champ absent ou `null` n'est ni un zéro ni une estimation : la source ne l'a pas renseigné.

## Erreurs et quotas

Cet outil ne consomme aucune unité de dossier : chercher est gratuit, c'est la lecture d'un dossier (`marches_dce`, `mairies_deliberations` et leurs téléchargements) qui est décomptée.

Les compteurs d’appels et de dossiers sont communs. Chaque action peut aussi être soumise à des droits et plafonds métier : [Codes d'erreur](https://prescriptio.fr/docs/reference/erreurs) et [Authentification et quotas](https://prescriptio.fr/docs/reference/authentification#les-quotas).

## Les skills qui s'en servent

- [prescriptio-suivre-projets](https://prescriptio.fr/skills/prescriptio-suivre-projets) : Le skill du plugin qui route cet outil

## Les pages qui s'en servent

Calculé depuis la documentation : chaque page qui cite `projets_rechercher`.

- [Projets](https://prescriptio.fr/docs/projets) : Documentation, Les modules
- [Radar réseaux sociaux](https://prescriptio.fr/docs/radar-reseaux-sociaux) : Documentation, Les modules
- [Les permis de construire (Sitadel)](https://prescriptio.fr/docs/donnees/permis-de-construire) : Documentation, Les données
- [Suivre les projets de construction d'un territoire et leurs acteurs](https://prescriptio.fr/docs/guides/suivre-les-projets-d-un-territoire) : Guides, Prescripteur de matériaux
- [Prompts du prescripteur de matériaux](https://prescriptio.fr/docs/prompts/prescripteur-materiaux) : IA, Prompts par métier
- [Prompts du bureau d'études](https://prescriptio.fr/docs/prompts/bureau-etudes) : IA, Prompts par métier
- [Rechercher et suivre des projets](https://prescriptio.fr/skills/prescriptio-suivre-projets) : IA, Les skills du plugin
- [Comment repérer un projet de construction avant l'appel d'offres ?](https://prescriptio.fr/docs/connaissances/reperer-projet-avant-appel-offres) : Base de connaissances, Repérer les affaires

## Voir aussi

- [projets_fiche_lire](https://prescriptio.fr/docs/api/projets_fiche_lire) : Lire une fiche projet fusionnée par son UUID : résumé factuel, preuves datées et références sources,…
- [projets_suivi_modifier](https://prescriptio.fr/docs/api/projets_suivi_modifier) : Agir sur un projet dans votre organisation avec la même transaction que l’interface
- [projets_analyse](https://prescriptio.fr/docs/api/projets_analyse) : Analyse du secteur dans l’écran Projets
- [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module