Carte des artisans smart home integration, free and open source
Find certified craftsmen near your home (French public data, Sirene).
Published by tlse-vins
- Devices
- Version 1.0.0
- Requires Gladys >=5.1.0
- ★ 0
Find craftsmen of a trade around your house, right in Gladys: plumbers, electricians, carpenters, bakers, mechanics… The integration reads the public data of the Carte des artisans, an independent website (not affiliated with Insee or the French chambers of trades) listing more than 3 million active craft businesses in mainland France and Corsica. Trade names and texts are in French.
Before you start
- Gladys 5.1 or later.
- Your house location must be set in Settings › Houses. The integration searches around the first located house (alphabetical order).
- The installation asks for the house location: it is only used to compute distances, inside Gladys, and never sent to the website or any other service.
There is nothing to set up in the Configuration tab: the Test the connection button checks that the data can be read and that the house is located.
"Craftsmen near me" widget
Add it to a dashboard, then choose in its settings:
- Trade: one of the 126 trades of the map;
- Radius: 5, 10, 25 or 50 km around the house;
- Certified companies only (RGE, EPV, master craftsman).
The widget shows how many craftsmen were found and up to 8 businesses. Tap one to see its activity, address, certifications, phone number when the craftsman added it, and the Details and Directions links. Open the map opens the website map for this trade and your town (never your exact location).
Add several widgets to follow several trades.
Order of the results
As on the website: certified businesses (RGE, Living Heritage Company, master craftsman) first, then the nearest.
"Sponsored" entries
Up to 3 entries marked Sponsored may appear at the top of the list: craftsmen who subscribed to the paid "recommended craftsman" option for this trade in your department or town. They are drawn at random, always marked, and never change the other results or their order. The scene action never returns them. Details: ranking rules (in French).
"Find a craftsman" scene action
In the scene editor, Integrations category. Choose the trade, the radius and optionally "certified only". The action gives the next actions of the scene:
| Variable | Content |
|---|---|
trouve | true when at least one craftsman was found |
nombre | number of craftsmen within the radius |
nom | name of the first craftsman (certified first) |
telephone | phone number, when added on the website |
adresse | address |
distance | distance to the house ("2,4 km") |
lien | link to the business page on cartedesartisans.fr |
Data and privacy
- Sources: Sirene (Insee) and the trades register (CMA), open licence, updated monthly; RGE (ADEME) and EPV (DGE) certifications.
- The integration only downloads the files it needs (one per trade and nearby
department, a few kilobytes), keeps them in its
/datafolder and only reads them again after the monthly update. What craftsmen add themselves (phone, master craftsman title, recommended craftsmen) is read again every 6 hours. - Nothing about you is sent: no location, no identifier, no cookie. Links to
the website only carry
mtm_campaign=gladys, to count visits coming from Gladys.
Troubleshooting
- "Set your house location": set it in Settings › Houses, then reopen the dashboard.
- "This trade no longer exists": the trade was removed from the website; pick another one in the widget settings.
- No result: widen the radius.
- Wrong information about a business (address, removal request): use the "Signaler une erreur" link of its page on the website.
Configuration settings
These are the settings Carte des artisans asks for in its configuration screen in Gladys.
| Setting | Type | Required | Description |
|---|---|---|---|
| How it works | section | No | Nothing to set up here: the integration searches around the location of your Gladys house. Add the "Craftsmen near me" widget to a dashboard, or the "Find a craftsman" action to a scene. Data: Sirene (Insee) and the French chambers of trades register, updated monthly, read from cartedesartisans.fr, an independent website (not affiliated with Insee or the chambers of trades). Your location never leaves Gladys. |
How to install Carte des artisans in Gladys
- In Gladys, open Integrations: Carte des artisans appears in the catalog, next to the native integrations, with a community badge.
- Click Install. Gladys pulls the Docker image (
ghcr.io/tlse-vins/gladys-carte-des-artisans:1.0.0), starts it in a sandbox isolated from the core, and generates the integration's interface (devices, discovery and configuration). - Open the Configuration screen of the integration, fill in the settings, and save.
- You can also install it directly from its repository URL: https://github.com/tlse-vins/gladys-carte-des-artisans.
Carte des artisans requires Gladys >=5.1.0. The catalog inside Gladys refreshes every hour, so a new version becomes available at most one hour after its release.
Not running Gladys yet? It is free and open source: follow the installation guide to get started.
About external integrations
Carte des artisans is an external integration: a community integration packaged as a Docker container and published on GitHub, that Gladys installs in one click and runs in a sandbox isolated from its core. It is published and maintained by tlse-vins, not by the Gladys core team.
- Browse all integrations, native and community
- Build and publish your own external integration
- Source code on GitHub — source of this documentation