ConfigurerNagare.

Démarrer

Comment marche Nagare

Nagare lit les sites publics de vos concurrents dans le temps, garde chaque version de chaque page qu’il lit, et vous dit ce qui a changé, quand, et ce que ça peut vouloir dire. Chaque phrase qu’il écrit renvoie à la page, au changement ou au signal qui la soutient.

• Un espace de travail contient tout : votre produit, vos concurrents, votre équipe et vos réglages.
• Votre produit est la référence de toute comparaison. Vous le décrivez dans un knowledge.md, et Nagare lit aussi votre propre site.
• Les concurrents sont lus sur leurs pages publiques, leur GitHub public, les documents d’API qu’ils publient et, pour l’année d’avant votre arrivée, l’archive de Common Crawl.
• Les signaux viennent d’en dehors de leur site : postes ouverts, levées de fonds, publicités Google, trafic, avis PeerSpot.
• Les briefs et les rapports en font quelque chose à lire : ce qui a bougé, ce que ça veut probablement dire, ce qu’il faut surveiller ensuite.

La lecture des sites, de l’archive, des documents d’API et de GitHub se fait sans IA. Un modèle trie les changements et écrit les briefs, les battlecards et les trajectoires, chaque phrase citant sa preuve. Il n’y a pas de chat dans Nagare : votre propre assistant le lit par le serveur MCP.

Démarrer

Votre compte

Pendant la bêta, les comptes ouvrent sur invitation. Votre invitation ouvre une inscription pour votre adresse ; s’inscrire par elle confirme votre e-mail du même coup.

1. Ouvrez votre invitation et remplissez Nom, E-mail professionnel et Mot de passe (10 caractères ou plus ; la longueur est la seule règle).
2. Une inscription sans lien d’invitation demande d’abord de confirmer l’e-mail : le lien fonctionne une fois, pendant 48 heures. Envoyer un nouveau lien en envoie un autre, trois par heure au plus.
3. Votre premier espace est créé, nommé d’après le domaine de votre e-mail ; vous en êtes propriétaire. Vous pouvez le renommer au premier lancement.

Se connecter

• Une session dure 30 jours, dans un cookie sécurisé que le code de la console ne lit jamais.
• Après cinq tentatives échouées sur une adresse, Nagare demande d’attendre quelques minutes.
• Mot de passe oublié ? envoie un lien valable une heure. Choisir un nouveau mot de passe ferme toutes les sessions. La réponse est la même qu’un compte existe ou non pour l’adresse.

Démarrer

Premier lancement

Un nouveau compte arrive sur trois courtes étapes. Passer pour l’instant mène directement au Brief ; tout se change ensuite.

1. Espace. Son nom, tel que votre équipe le verra.
2. Concurrents. Collez jusqu’à cinq sites, un par ligne, et si vous voulez le site de votre propre produit (suivi comme les autres, il ne compte jamais comme un concurrent). Chaque ligne est vérifiée pendant la saisie : une adresse qui n’est pas un site est laissée de côté, un site qui ne répond pas est ajouté quand même, et un site qui mène chez une autre société est laissé de côté. Un site qui passe sur son jumeau www est suivi là où il vit. Chacun est ensuite lu chaque semaine, avec une première lecture lancée tout de suite. Les sections docs, référence d’API ou blog de plus de 100 pages sont proposées désactivées.
3. Brief. Le jour, l’heure et le fuseau horaire de votre brief hebdomadaire (tout fuseau). Pendant la bêta, les briefs et les alertes sont dans Nagare : l’e-mail et Slack apparaissent comme bientôt disponibles.

Ajoutez d’autres concurrents ensuite depuis Ajouter un concurrent, dans la barre latérale.

Démarrer

La console

⌘K (Ctrl K hors Mac) cherche concurrents, pages et changements dès deux lettres, et propose Ajouter un concurrent, Rédiger le brief maintenant et Tout marquer comme lu.

Votre marché

Votre produit

Toute comparaison se fait face à votre produit : la matrice des fonctionnalités, le tableau des prix, les battlecards et la partie « Vous » du brief. Votre produit a trois onglets pour ce que vous dites (Vue d’ensemble, Connaissances, Catalogue) et, quand votre propre site est suivi, ce que le web en dit.

• Vue d’ensemble. « Ce que vous faites », « À qui vous vendez », vos offres et vos capacités. Un bloc lu dans un document le dit, avec un bouton pour le confirmer ; ce que vous modifiez à la main l’emporte sur les documents.
• Catalogue. Vos fonctionnalités par groupes, et les Suggestions : des fonctionnalités trouvées chez vos concurrents. Pour chacune, Ajouter au catalogue, répondre à « Et vous, vous l’avez ? » (Oui, En partie, Non), Fusionner avec… une existante, ou Écarter.
• Offres. Ajoutez-les à la main, ou depuis le tableau des prix de votre knowledge.md. Une offre saisie à la main est marquée comme telle et l’emporte sur ce que disent vos pages.
• Votre site. Suivi comme celui d’un concurrent, avec Crawler maintenant en haut de la page.

Votre marché

Le knowledge.md

Un fichier Markdown dit ce que votre produit est, fait et coûte. Nagare le lit sans IA, dans une structure fixe, et il reste privé à votre espace. Téléchargez le modèle depuis Votre produit → Connaissances (Télécharger le modèle), remplissez-le, puis ajoutez-le.

Ses sections

Des titres de niveau 2, en anglais ou en français :

• Positionnement (Positioning) : une ou deux phrases, ce qu’est le produit, pour qui, sa promesse principale.
• Cible (Audience) : une ligne par segment à qui vous vendez.
• Fonctionnalités (Features) : regroupées sous des titres de niveau 3, une par puce sous la forme **Nom** — ce qu’elle fait, puis si utile Plans:, Status: partial et Aliases: (les noms que les concurrents lui donnent).
• Non proposé (Not offered) : ce que vous n’avez pas et qu’on vous demande. Il apparaît « Non » dans votre colonne.
• Tarifs (Pricing) : une ligne Currency:, puis un tableau Plan | Price | Billing | Limits | Notes, de la moins chère à la plus chère.

## Fonctionnalités

### Ciblage
- **Déploiement progressif** — Ouvrir une fonctionnalité à une part croissante des utilisateurs.
  Plans: Free, Team, Business
  Aliases: progressive delivery, canary release

## Tarifs
Currency: EUR

| Plan | Price | Billing | Limits | Notes |
|---|---|---|---|---|
| Free | 0 | per month | 1 projet | |
| Team | 39 | per month | 5 projets | essai de 14 jours |

L’ajouter

• Ajouter des connaissances → Coller du texte, ou Déposer un fichier (.md ou .txt) : votre navigateur lit le fichier et en envoie le texte.
• 200 000 caractères au plus. Déposez-le à nouveau chaque fois qu’il change.
• Chaque document dit s’il a été lu, et ce qui a servi est souligné dans le lecteur.

Votre marché

Les concurrents

En ajouter un

1. Ajouter un concurrent : leur site, et un nom si vous le souhaitez.
2. Nagare cartographie le site en quelques secondes, sans encore le crawler : où il vit, son robots.txt, son sitemap, ses pages rangées en sections, et ce qu’un crawl lirait. Un site qui mène chez une autre société n’est jamais suivi ; un site qui ne répond pas peut être ajouté quand même.
3. Sections à suivre. La page d’accueil et les pages non classées sont toujours suivies ; les sections à gros volume démarrent désactivées. Les autres sites à eux trouvés pendant la cartographie peuvent être ajoutés comme sources.
4. À quelle fréquence. Hebdomadaire (lu une fois par semaine, avant le brief), Quotidienne, ou Manuelle (seulement quand vous lancez un crawl). Capturer la référence maintenant lance la première lecture. L’étape estime les pages par crawl et par mois face à votre offre.

La première lecture

Ses étapes s’affichent au fur et à mesure, sur la page du concurrent :

• Leur site, page par page.
• Leur compte GitHub : l’organisation vers laquelle pointent leurs pages, ses dépôts et ses versions (revérifié tous les 7 jours).
• Leurs documents d’API : le document OpenAPI qu’ils publient, sur leur site d’abord, puis dans leurs SDK sur GitHub.
• Leur année passée : leurs pages d’accueil et de prix sur les 12 derniers mois, par Common Crawl, une capture par mois au plus, toujours marquée comme archivée et moins fiable.
• Leurs signaux, puis L’année d’avant, un rapport de cette année mois par mois.

Ensuite

• Crawler maintenant lit un site tout de suite (un crawl à la fois par site).
• L’onglet Pages ignore une page ou la suit à nouveau ; l’onglet Sources ajoute une source, laisse des sections de côté, change la fréquence et peut plafonner les pages par crawl.
• Retirer une source garde son historique.
• Nagare lit en tant que NagareBot : identifié, robots.txt respecté, le même site seulement, jamais derrière une connexion. Comment se comporte NagareBot.

Le nombre de concurrents et de pages compris dans votre offre est sur Usage et offre ; votre propre produit ne compte jamais comme un concurrent.

Votre marché

Les signaux

Les signaux viennent d’en dehors du site d’un concurrent et arrivent dans son onglet Signaux et dans vos briefs. Chacun nomme sa source.

• Postes ouverts : depuis leur page carrières et les offres d’emploi publiées.
• Levées de fonds.
• Publicités Google, depuis le Centre de transparence publicitaire de Google.
• Trafic.
• Avis, depuis PeerSpot seulement.

Les liens viennent des crawls ; les documents d’API sont cherchés chaque semaine et GitHub tous les 7 jours : aucun n’a de cadence à régler.

À quelle fréquence chacun est demandé

Réglages → Briefs et signaux, partie Signaux : Chaque jour, Chaque semaine, Toutes les 2 semaines, Chaque mois, ou Arrêté (demandé seulement par une vérification à la demande). Chaque famille démarre en hebdomadaire, le trafic en mensuel. Chaque ligne indique ce qu’elle coûte par site et par mois en crédits, et le total compte chaque site interrogé, votre produit compris. Vérifier, sur les onglets de signaux d’un concurrent, demande toutes les familles d’un coup. Les admins et les propriétaires changent les cadences ; les membres les lisent.

Lire

Les briefs

Un brief dit ce qui a bougé chez vos concurrents depuis le précédent : les chiffres de la période, une synthèse avec ses sources, une partie par concurrent qui a bougé avec ce qu’il faut surveiller, ceux qui sont restés calmes, et ce qui a changé sur votre propre site.

Quand

• Réglages → Général : le jour, l’heure et le fuseau que partagent tous les briefs, le jour du brief mensuel (1 à 28), et combien d’heures avant le brief les sources sont lues (1 à 24, 2 par défaut).
• Réglages → Briefs et signaux : activez Quotidien, Hebdo, Toutes les 2 semaines ou Mensuel, autant que vous voulez. Un nouvel espace a l’hebdomadaire. Chacun couvre le temps depuis son créneau précédent.

Ce qu’il contient

Modifier le contenu, sur la ligne de chaque cadence :

• Changements listés : tous, ou notables et majeurs seulement.
• Longueur : de 10 à 200 changements au plus.
• Sections : levées de fonds, postes ouverts, publicités Google, liens, changements d’API, avis PeerSpot, Vous.
• Pages laissées de côté : toujours crawlées et toujours dans le fil ; seul ce brief les laisse de côté.

Rejouer un brief en écrit un entre deux dates de votre choix. Pendant la bêta, les briefs se lisent dans Nagare : l’envoi par e-mail et dans Slack arrive bientôt.

Lire

Les rapports

Tout membre peut demander un rapport. Dans le lecteur, Copier le Markdown le copie.

Diffusion Bientôt disponible

Canaux et alertes

Un canal est l’endroit où partent les briefs et les alertes. Les admins et les propriétaires les ajoutent, les testent et les retirent dans Réglages → Notifications → Ajouter un canal ; les membres voient la liste. Un espace a 20 canaux au plus.

• Les briefs qu’il reçoit : n’importe quelles cadences, l’hebdomadaire par défaut (un brief rejoué part là où part l’hebdomadaire).
• Alertes en temps réel : Désactivées, Majeures seulement, ou Notables et plus. Cinq alertes au plus par canal pour un crawl ; les autres attendent le brief.
• Envoyer un test envoie un message tout de suite et montre s’il est parti.
• Retirer demande confirmation. Chaque carte montre sa dernière diffusion, envoyée ou échouée et pourquoi.

Diffusion Bientôt disponible

E-mail

1. Ajouter un canal → E-mail, puis l’adresse (une personne ou une liste d’équipe).
2. Choisissez les briefs qu’elle reçoit et ses alertes en temps réel.
3. Envoyer un test : le message s’intitule « Nagare test notification ».

Les e-mails du compte (confirmer votre adresse, réinitialiser un mot de passe, les invitations) ne dépendent pas de ces canaux.

Diffusion Bientôt disponible

Slack

Nagare publie dans Slack par un webhook entrant : une URL que Slack vous donne pour un canal. Nagare n’a besoin d’aucun autre accès à votre Slack.

Dans Slack

1. Allez sur api.slack.com/apps et choisissez Create New App → From scratch. Donnez-lui un nom (par exemple « Nagare ») et choisissez votre espace Slack.
2. Ouvrez Incoming Webhooks et activez-les.
3. Add New Webhook to Workspace, choisissez le canal et autorisez. Si votre espace Slack restreint les applications, un de vos admins devra peut-être l’approuver.
4. Copiez l’URL du webhook. Elle commence par https://hooks.slack.com/services/.

Dans Nagare

1. Ajouter un canal → Slack, collez l’URL, donnez-lui un nom si vous voulez (par exemple #veille-concurrentielle).
2. Choisissez ses briefs et ses alertes, puis Envoyer un test.

Nagare n’accepte que des adresses https://hooks.slack.com/…. L’URL fonctionne comme un mot de passe : Nagare l’affiche masquée une fois enregistrée. Un brief arrive comme une synthèse avec une partie par concurrent et un bouton Open in Nagare ; une alerte comme une ligne avec sa gravité, le concurrent et la catégorie, liée au changement, et un bouton View diff.

Diffusion Bientôt disponible

Webhooks

Pour votre propre service : Nagare envoie du JSON en POST à une adresse https qui ne résout que vers des adresses IP publiques (revérifié à chaque envoi). Il ne suit aucune redirection, attend 10 secondes, et tente chaque diffusion trois fois.

Ce qu’il envoie

Le corps a toujours type et workspace (id, name, slug, timezone) ; une alerte ajoute change et url, un brief ajoute report (son titre, sa période, son titre de une, sa synthèse, ses points saillants, ses preuves et son lien).

Vérifier la signature

Chaque webhook a son propre secret de signature (whsec_…), montré une fois à l’ajout du canal ; Changer le secret en émet un nouveau, et l’ancien cesse aussitôt. v1 est le HMAC-SHA256, avec ce secret, de <t>. suivi du corps brut. Vérifiez le corps brut avant de le lire en JSON, comparez en temps constant, et refusez un t ancien :

import hashlib, hmac, time

def from_nagare(secret: str, body: bytes, header: str, tolerance_s: int = 300) -> bool:
    parts = dict(part.split("=", 1) for part in header.split(","))
    t = int(parts["t"])
    if abs(time.time() - t) > tolerance_s:
        return False
    expected = hmac.new(secret.encode(), f"{t}.".encode() + body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(parts.get("v1", ""), expected)

import { createHmac, timingSafeEqual } from 'node:crypto';

export function fromNagare(secret, rawBody, header, toleranceS = 300) {
  const parts = Object.fromEntries(header.split(',').map((p) => p.split('=')));
  const t = Number(parts.t);
  if (Math.abs(Date.now() / 1000 - t) > toleranceS) return false;
  const expected = createHmac('sha256', secret).update(`${t}.`).update(rawBody).digest('hex');
  const given = Buffer.from(parts.v1 ?? '', 'utf8');
  return given.length === expected.length && timingSafeEqual(given, Buffer.from(expected));
}

Les messages Slack ne sont pas signés : là, le secret est l’URL du webhook elle-même.

Votre IA

Clés d’API

Réglages → Clés d’API, pour les admins et les propriétaires. Créez une clé, donnez-lui un nom, et copiez-la : elle n’est montrée qu’une fois. Une clé ressemble à ngr_k_… et se place dans un en-tête :

Authorization: Bearer ngr_k_…

Qui détient une clé utilise l’API comme un membre de cet espace : il peut lire et modifier ses concurrents, ses changements et ses rapports. Une clé appartient à un seul espace et n’expire pas ; Révoquer refuse ses requêtes aussitôt, définitivement. Les mêmes clés relient vos outils d’IA au serveur MCP.

Votre IA

Serveur MCP

Claude Code ou vos propres agents interrogent Nagare directement : concurrents, changements, historique des pages, briefs et rapports, matrice des fonctionnalités, prix, connaissances, messages, thèmes, cycle de vie, leur API, leur GitHub, avis, pages non liées et clients. Chaque outil est en lecture seule, chaque réponse vient avec sa preuve, et le serveur n’appelle aucun modèle.

1. Créez une clé d’API.
2. Ouvrez Réglages → IA et exports, carte Nagare dans vos outils d’IA : elle montre l’adresse du serveur, sa limite par minute et ses outils.
3. Copiez la commande pour Claude Code, ou le JSON pour les autres clients, et mettez votre clé là où il est écrit ngr_k_… :

claude mcp add --transport http nagare <adresse du serveur> \
  --header "Authorization: Bearer ngr_k_…"

{
  "mcpServers": {
    "nagare": {
      "type": "http",
      "url": "<adresse du serveur>",
      "headers": {
        "Authorization": "Bearer ngr_k_…"
      }
    }
  }
}

Révoquez la clé pour couper un agent aussitôt.

Votre IA

Exports llms-full.txt

Le site entier de chaque source en texte propre, prêt pour votre propre modèle : Réglages → IA et exports, un llms-full.txt par site, votre produit en premier. Un fichier apparaît après le premier crawl complet d’une source et n’est régénéré que si son contenu a changé. Téléchargez-le, ou copiez son URL : l’adresse demande une clé d’API.

curl -L -H "Authorization: Bearer ngr_k_…" <l’URL copiée>

Espace

Membres et rôles

Inviter

1. Réglages → Membres → Inviter un membre : un e-mail et un rôle (Membre par défaut).
2. Nagare envoie l’invitation par e-mail ; son lien est aussi montré une fois, pour le copier. Il fonctionne 7 jours.
3. Invitations en attente : Renvoyer crée un nouveau lien (le précédent cesse de fonctionner), Révoquer l’annule.

Un espace garde toujours un propriétaire : le dernier ne peut ni partir ni être rétrogradé. Le nombre d’espaces qu’une personne peut posséder dépend de l’offre ; le sélecteur en haut de la barre latérale l’indique.

Espace

Usage et offre

Réglages → Usage et offre, ouvert à tout l’espace : ce qu’il peut crawler chaque mois et ce qu’il a utilisé.

• Crédits Firecrawl ce mois-ci : les crawls avec rendu et les vérifications de signaux. Quand un budget mensuel est fixé, les propriétaires reçoivent un e-mail à 80 %, et à 100 % les crawls Firecrawl et les vérifications de signaux attendent le mois suivant. Les crawls du robot HTTP de Nagare ne coûtent aucun crédit et n’attendent jamais.
• Offre : concurrents, pages par source et pages suivies.
• Jour par jour : pages crawlées, crédits de rendu, jetons d’IA ; et Par concurrent, la cadence et la part de chacun.

Espace

Vos données

• Télécharger mes données (Réglages → Votre compte) : un fichier JSON de ce que Nagare garde sur vous : votre compte, vos espaces et vos rôles, vos sessions, vos clés d’API, les invitations que vous avez envoyées, et ce que vous avez configuré dans les espaces que vous possédez. Il ne contient jamais d’empreinte de mot de passe ni de jeton.
• Supprimer mon compte, avec votre mot de passe : immédiat, sans restauration. Votre compte, vos sessions et chaque espace où vous êtes seul sont effacés. C’est refusé tant que vous êtes le seul propriétaire d’un espace utilisé par d’autres : nommez d’abord un autre propriétaire.
• Supprimer l’espace (Réglages → Général → Zone de danger, propriétaires seulement) : tapez son nom pour confirmer. Un propriétaire peut le restaurer pendant 30 jours ; ensuite il est effacé pour de bon.

Votre knowledge.md reste privé à votre espace.

Espace

Aide

• Une question, un bug, une idée : support@kaiten.sh.
• Vos données personnelles : privacy@kaiten.sh.
• Vous possédez un site que Nagare lit : la page de NagareBot dit comment il se comporte et comment le limiter.