YepAPI/skills

Workflow SEO Local

Recherche d'entreprises locales utilisant les données de Google Maps et des SERP locales via les endpoints YepAPI.

Endpoints utilisés

Endpoint	Coût	Objectif
POST /v1/serp/google/maps	0,01 $	Résultats Google Maps / entreprises locales
POST /v1/scrape	0,01 $	Scraper les sites concurrents pour les données NAP
POST /v1/seo/keywords	0,15 $	Métriques de mots-clés locaux (volume, difficulté)
POST /v1/seo/page-audit	0,03 $	Vérifier les signaux SEO local sur le site de l'utilisateur

Workflow

Étape 1 : Découverte des concurrents locaux

Exécutez POST /v1/serp/google/maps avec la catégorie d'activité et la localisation.

{
  "query": "plombier à austin tx",
  "location": "us"
}

Retourne : fiches d'entreprises locales avec évaluations, nombre d'avis, catégories, adresses.

Étape 2 : Extraction des données NAP

Pour chaque concurrent, exécutez POST /v1/scrape sur leur site web.

{
  "url": "https://concurrent-plombier.com",
  "format": "markdown"
}

Extrayez les données NAP (Nom, Adresse, Téléphone) pour comparer la cohérence entre les fiches.

Étape 3 : Recherche de mots-clés locaux

Exécutez POST /v1/seo/keywords avec des mots-clés locaux.

{
  "keywords": ["plombier à austin", "plombier urgence austin tx", "service plomberie austin"],
  "location": "us"
}

Retourne : volume de recherche local, CPC, difficulté — les mots-clés locaux ont un volume plus faible mais une intention plus élevée.

Étape 4 : Audit on-page

Exécutez POST /v1/seo/page-audit sur le site de l'utilisateur.

{
  "url": "https://exemple-plombier.com"
}

Vérifiez les signaux SEO local : données structurées (schéma LocalBusiness), cohérence NAP, mots-clés de localisation dans les balises meta.

Étape 5 : Présentation des résultats

• Paysage concurrentiel local (évaluations, nombre d'avis, classements)
• Opportunités de mots-clés (termes locaux avec volume et difficulté)
• Correctifs on-page (données structurées manquantes, incohérences NAP, lacunes dans les balises meta)

Règles

• Incluez toujours la localisation dans les requêtes Maps — les résultats dépendent de la localisation
• La cohérence NAP est cruciale pour le SEO local — signalez les écarts
• Les résultats Google Maps incluent les évaluations, le nombre d'avis et les catégories — utilisez-les pour l'analyse comparative des concurrents
• Les mots-clés locaux ont un volume plus faible mais une intention plus élevée — priorisez le potentiel de conversion

Gestion des erreurs

• NO_CREDITS (402) — Dites à l'utilisateur d'ajouter des crédits sur https://yepapi.com/dashboard
• UPSTREAM_ERROR (502) — Réessayez une fois ; si cela échoue à nouveau, ignorez cette étape et notez-la
• VALIDATION_ERROR (400) — Vérifiez le format de la requête ; incluez la localisation dans la chaîne de requête
• RATE_LIMITED (429) — Attendez et réessayez ; respectez l'en-tête Retry-After