Communitygithub.com

modbender/skill-library-mcp

Interrogez la propriété foncière, les baux, les informations sur les propriétaires et les paiements fonciers. Opérations d'écriture pour la gestion des paiements et les renouvellements de baux.

Qu'est-ce que skill-library-mcp ?

Cette compétence (skill) pour agent IA offre un accès complet à un système de gestion foncière (FarmOS) pour suivre les terrains possédés et loués, les conditions des baux, les relations avec les propriétaires, les paiements et les coûts fonciers annuels. Elle est conçue pour être utilisée avec des clients d'agents IA comme Claude Code ou Cursor, en interrogeant une API REST locale. La compétence gère strictement les données complètes : elle interdit l'utilisation d'endpoints tronqués (comme le tableau de bord qui ne renvoie que 5 éléments) et impose de signaler tout échec de récupération de données. Les opérations de lecture (liste des paiements, baux, propriétaires) se font via des endpoints d'intégration sans authentification, tandis que les opérations d'écriture (marquage des paiements comme effectués, renouvellements de baux) nécessitent un jeton JWT obtenu via un script shell. La compétence inclut des fonctionnalités avancées comme le renouvellement groupé de baux avec prévisualisation, le marquage groupé de paiements par période, et le roulement de fin d'année pour créer les échéanciers de l'année suivante. L'accès aux données sensibles (conditions de bail, montants des loyers, informations des propriétaires) est restreint aux rôles administrateur et gestionnaire, vérifiés via un fichier de rôles local.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/modbender/skill-library-mcp/tree/HEAD/data/farmos-land-portfolio

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Portefeuille Foncier FarmOS

Suivez les terrains possédés et loués, les conditions des baux, les relations avec les propriétaires, les paiements et les coûts fonciers annuels.

RÈGLES CRITIQUES D'INTÉGRITÉ DES DONNÉES

N'utilisez JAMAIS de données partielles ou tronquées. Ces règles sont non négociables :

  1. N'utilisez JAMAIS /api/integration/dashboard — il tronque les résultats à 5 éléments. Des données de paiement partielles sont pires que pas de données car elles créent une fausse impression de complétude.
  2. Utilisez TOUJOURS les endpoints /all listés ci-dessous pour des données complètes.
  3. Si un endpoint renvoie une erreur ou des résultats vides, SIGNALEZ L'ÉCHEC à l'utilisateur. Ne vous rabattez pas silencieusement sur un autre endpoint et ne présentez pas de données partielles.
  4. Indiquez TOUJOURS le nombre total d'enregistrements renvoyés afin que l'utilisateur sache que les données sont complètes. Exemple : "11 paiements trouvés à échéance en mars pour un total de 175 058 €."
  5. Si vous ne pouvez pas obtenir des données complètes, dites-le explicitement. "Je n'ai pas pu récupérer les données de paiement complètes" est infiniment mieux que d'afficher 5 paiements sur 11.

Quand cette compétence se déclenche

  • "Quand nos baux expirent-ils ?"
  • "Quel est le loyer de la parcelle Smith ?"
  • "Coûts fonciers totaux cette année ?"
  • "Afficher les paiements en retard"
  • "Coordonnées du propriétaire"
  • "Coût par acre par parcelle"
  • "Lister toutes les parcelles louées"
  • "Quels paiements sont dus en mars ?"
  • "Besoins de trésorerie pour le mois prochain"
  • "Marquer le paiement [X] comme payé"
  • "Marquer tous les paiements de mars comme payés"
  • "Renouveler le bail Smith"
  • "Aperçu des renouvellements de baux"

Contrôle d'accès

Les conditions des baux, les montants des loyers et les informations des propriétaires sont des données commerciales sensibles. Réservez l'accès aux rôles administrateur ou gestionnaire uniquement.

Correspondance des rôles : Vérifiez le rôle de l'expéditeur dans ~/.openclaw/farmos-users.json. Si l'utilisateur n'est pas administrateur ou gestionnaire, dites-lui qu'il n'a pas accès aux données du portefeuille foncier.

Base de l'API

http://100.102.77.110:8009

Endpoints d'intégration (aucune authentification requise) — OPÉRATIONS DE LECTURE UNIQUEMENT

IMPORTANT : Utilisez les endpoints authentifiés pour les opérations d'ÉCRITURE (marquer comme payé, renouvellements). Utilisez les endpoints /all d'intégration pour les opérations de LECTURE (liste des paiements, baux, propriétaires).

Paiements (COMPLET — utilisez celui-ci, pas le tableau de bord)

GET /api/integration/payments/all

  • Renvoie TOUS les paiements avec tous les détails — noms des parcelles, noms des propriétaires, statut de retard
  • Paramètres de requête :
    • status — pending (en attente), paid (payé), overdue (en retard), scheduled (planifié)
    • payment_type — rent (loyer), mortgage (prêt immobilier), property_tax (taxe foncière), insurance (assurance), improvement (amélioration), other (autre)
    • parcel_id — filtrer par parcelle spécifique
    • due_date_from — début de la plage de dates (AAAA-MM-JJ)
    • due_date_to — fin de la plage de dates (AAAA-MM-JJ)
    • crop_year — filtrer par année culturale
  • Exemples :
    • Tous en retard : /api/integration/payments/all?status=overdue
    • Paiements de mars 2026 : /api/integration/payments/all?due_date_from=2026-03-01&due_date_to=2026-03-31
    • Tous les loyers : /api/integration/payments/all?payment_type=rent

Paiements à venir (N prochains jours)

GET /api/integration/payments/upcoming?days=30

  • Renvoie TOUS les paiements à venir dans N jours (pas de troncature)
  • Utilisez days=60 ou days=90 pour une anticipation plus longue

Baux (COMPLET)

GET /api/integration/leases/all

  • Renvoie TOUS les baux avec les coordonnées du propriétaire, les conditions de loyer, le statut d'expiration
  • Paramètres de requête :
    • status — active (actif), expired (expiré)
    • landlord_id — filtrer par propriétaire

Baux expirant

GET /api/integration/leases/expiring?days=90

  • Renvoie TOUS les baux expirant dans N jours

Propriétaires (COMPLET)

GET /api/integration/landlords/all

  • Renvoie TOUS les propriétaires avec leurs coordonnées, le nombre de baux actifs, le nombre total d'acres, le loyer total

Parcelles

GET /api/integration/parcels

  • Renvoie TOUTES les parcelles avec le type de propriété, la superficie en acres, le comté
  • Paramètre de requête : ownership_type — owned (possédée), leased (louée)

Statistiques récapitulatives

GET /api/integration/summary

  • Nombre total d'acres, répartition possédée/louée, nombre de parcelles/baux/propriétaires, coût annuel

Coûts fonciers annuels (par mois et par entité)

GET /api/integration/finance/costs?year=2026

  • Répartition mensuelle des coûts par catégorie (loyer, prêt immobilier, taxe, assurance)
  • Répartition par entité
  • Paramètres de requête : year, entity_id

Coût par champ (pour le compte de résultat)

GET /api/integration/finance/cost-per-field?year=2026

  • Coûts fonciers alloués aux champs de production
  • Paramètres de requête : year, entity_id

Éléments en retard

GET /api/integration/tasks/overdue

  • Tous les paiements et rappels en retard — éléments haute priorité

Éléments actionnables

GET /api/integration/tasks/actionable?days_ahead=30

  • Paiements à venir, baux expirant, rappels en attente

Endpoints authentifiés — OPÉRATIONS D'ÉCRITURE

Ceux-ci nécessitent une authentification JWT. Voir la section Authentification ci-dessous.

Authentification

Cette compétence accède à des endpoints FarmOS protégés qui nécessitent un jeton JWT.

Pour obtenir un jeton : Exécutez l'assistant d'authentification avec le rôle approprié :

TOKEN=$(~/clawd/scripts/farmos-auth.sh admin)

Pour utiliser le jeton : Incluez-le comme jeton Bearer :

curl -H "Authorization: Bearer $TOKEN" http://100.102.77.110:8009/api/endpoint

Expiration du jeton : Les jetons durent 15 minutes. Si vous obtenez une réponse 401, demandez un nouveau jeton.

Marquer un paiement unique comme payé

POST /api/payments/{id}/mark-paid Authorization: Bearer {token} Content-Type: application/json

Corps :

{
  "paid_date": "2026-02-15",
  "notes": "Chèque #1234"
}

Marquer plusieurs paiements comme payés (en masse)

POST /api/payments/bulk/mark-paid Authorization: Bearer {token} Content-Type: application/json

Corps :

{
  "payment_ids": [12, 34, 56],
  "paid_date": "2026-02-15",
  "notes": "Émission groupée de chèques"
}

Marquer les paiements comme payés par fourchette de dates

POST /api/payments/bulk/mark-paid-by-date Authorization: Bearer {token} Content-Type: application/json

Corps :

{
  "due_date_from": "2026-03-01",
  "due_date_to": "2026-03-31",
  "paid_date": "2026-02-15",
  "payment_type": "rent",
  "notes": "Paiements des loyers de mars"
}

Utilisez ceci lorsque l'utilisateur dit "marquer tous les paiements de mars comme payés" ou une autre opération groupée basée sur une date.

Prévisualiser le renouvellement d'un bail

POST /api/leases/renewal-preview Authorization: Bearer {token} Content-Type: application/json

Corps :

{
  "lease_ids": [5, 12],
  "new_start_date": "2027-03-01",
  "rent_increase_percent": 3.0
}

Renvoie : Un aperçu de ce à quoi ressembleraient les baux renouvelés, y compris les nouveaux échéanciers de paiement. Utilisez ceci AVANT d'exécuter les renouvellements groupés afin que l'utilisateur puisse confirmer.

Exécuter le renouvellement groupé de baux

POST /api/leases/bulk-renew Authorization: Bearer {token} Content-Type: application/json

Corps :

{
  "lease_ids": [5, 12],
  "new_start_date": "2027-03-01",
  "new_end_date": "2028-02-28",
  "new_rent_amount": 52000.00,
  "rent_increase_percent": 3.0,
  "notes": "Renouvellement annuel avec augmentation de 3%"
}

IMPORTANT : Faites toujours un aperçu d'abord, confirmez avec l'utilisateur, puis exécutez.

Prévisualisation du roulement de fin d'année

POST /api/payments/year-end-rollover/preview Authorization: Bearer {token} Content-Type: application/json

Corps :

{
  "from_year": 2026,
  "to_year": 2027
}

Renvoie : Un aperçu des échéanciers de paiement qui seraient créés pour la nouvelle année culturale.

Exécution du roulement de fin d'année

POST /api/payments/year-end-rollover/execute Authorization: Bearer {token} Content-Type: application/json

Corps :

{
  "from_year": 2026,
  "to_year": 2027,
  "apply_rent_increase": true,
  "rent_increase_percent": 2.5
}

IMPORTANT : Ceci crée les échéanciers de paiement de l'année prochaine en fonction des baux de l'année en cours. Faites toujours un aperçu d'abord.

Endpoints INTERDITS — Ne PAS utiliser

EndpointRaison
GET /api/integration/dashboardTronque à 5 éléments. N'utilisez JAMAIS ceci.

Concepts clés

  • Parcelle : Une unité foncière — possédée ou louée.
  • Types de baux : Loyer en espèces, part de récolte, loyer flexible.
  • Expiration du bail : Critique à suivre — les échéances approchantes nécessitent une attention proactive.
  • Paiements fonciers : Loyer, prêt immobilier, taxe foncière, assurance — chacun avec des dates d'échéance.

Notes d'utilisation

  • Le suivi de l'expiration des baux est la requête à plus forte valeur ajoutée — signalez toujours les baux expirant dans les 6 mois.
  • Le statut des paiements (dû/en retard) est critique — signalez immédiatement les paiements en retard.
  • L'analyse du coût par acre aide à comparer l'économie entre terrains possédés et loués.
  • Les coordonnées du propriétaire sont privées — ne les partagez jamais en dehors des canaux administrateur/gestionnaire.
  • Lorsqu'on vous interroge sur les "besoins de trésorerie" ou "ce que nous devons", utilisez toujours /api/integration/payments/all avec un filtre de dates pour obtenir l'image COMPLÈTE.
  • Pour les questions de planification financière, combinez /api/integration/payments/all avec /api/integration/finance/costs pour une vue complète.
  • Opérations d'écriture : Utilisez toujours les endpoints authentifiés pour marquer les paiements comme payés ou renouveler les baux. Faites un aperçu d'abord pour les opérations groupées.
  • Marquage groupé des paiements : Lorsque l'utilisateur dit "marquer tous les paiements de mars comme payés", utilisez l'endpoint groupé par date plutôt que des appels individuels.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

modbender/skill-library-mcp

Paid acquisition strategy, budget allocation, and avoiding common advertising mistakes across platforms

modbender/skill-library-mcp

Complete investment portfolio risk management system. Analyze positions, calculate risk metrics, stress test scenarios, optimize allocations, and generate institutional-grade risk reports — all wit...

modbender/skill-library-mcp

Borrow from Aave via credit delegation. Agent self-funds by borrowing against delegator collateral. Supports borrow, repay, health checks. Works on Aave V2/V3.

modbender/skill-library-mcp

Discover and register autonomous AI agents. Use when: browsing the agent registry, submitting an agent for verification, or embedding agent badges. NOT for: general web search or agent capability analysis.

modbender/skill-library-mcp

Create AI avatar and talking head videos with OmniHuman, Fabric, PixVerse via inference.sh CLI. Models: OmniHuman 1.5, OmniHuman 1.0, Fabric 1.0, PixVerse Lipsync. Capabilities: audio-driven avatars, lipsync videos, talking head generation, virtual presenters. Use for: AI presenters, explainer videos, virtual influencers, dubbing, marketing videos. Triggers: ai avatar, talking head, lipsync, avatar video, virtual presenter, ai spokesperson, audio driven video, heygen alternative, synthesia alternative, talking avatar, lip sync, video avatar, ai presenter, digital human

modbender/skill-library-mcp

AI代码编辑器规则模板集合 - 为Cursor、Windsurf、Claude Code、Cline等AI编辑器提供项目规则配置。适用于需要配置AI编码助手规则的开发者,包含全栈Web、移动端、Vue3+SpringBoot等技术栈模板。

modbender/skill-library-mcp

Generate landing page code from product descriptions

modbender/skill-library-mcp

Create AI marketing videos for ads, promos, product launches, and brand content. Models: Veo, Seedance, Wan, FLUX for visuals, Kokoro for voiceover. Types: product demos, testimonials, explainers, social ads, brand videos. Use for: Facebook ads, YouTube ads, product launches, brand awareness. Triggers: marketing video, ad video, promo video, commercial, brand video, product video, explainer video, ad creative, video ad, facebook ad video, youtube ad, instagram ad, tiktok ad, promotional video, launch video

modbender/skill-library-mcp

Generate AI music videos end-to-end. Creates music with Suno (sunoapi.org), generates visuals with OpenAI/Seedream/Google/Seedance, and assembles into music video with ffmpeg. Supports timestamped lyrics (auto SRT), Suno native music video generation, slideshow/video/hybrid modes. Token-based cost tracking per generation.

modbender/skill-library-mcp

Generate AI-powered notes from videos (document, outline, or graphic-text formats)

modbender/skill-library-mcp

The video AI notes tool is provided by Baidu. Based on the video download address provided by the user, it downloads and parses the video, and finally generates AI notes corresponding to the video (a total of three types of notes can be generated: document notes, outline notes, and image-text notes).

modbender/skill-library-mcp

Automated appointment management for beauty salons, clinics, studios, and photo booths. Handles booking requests, calendar sync, conflict detection, reminders, no-show tracking, and waitlist management.

modbender/skill-library-mcp

Bird identification, life list tracking, and trading card generation. Use this skill when the user: sends a bird photo to identify, says "set up my Birdfolio" or "set my region", asks "how's my checklist", asks "Birdfolio progress", asks "how many birds have I found", asks "show my Birdfolio" or "show my life list", asks "what's my rarest bird", or asks "tell me about [bird species]". Handles everything from first-time setup through ongoing life list tracking and visual trading card generation.

modbender/skill-library-mcp

Multi-project task and research management (JSON-first CLI)

modbender/skill-library-mcp

Track stock and crypto portfolios with CLI - real-time prices, P&L, dividend tracking, multiple portfolios

modbender/skill-library-mcp

Track cryptocurrency portfolios with real-time prices, P&L calculations, and allocation analysis. Query Bitcoin, Ethereum, Solana and 10,000+ token holdings.

modbender/skill-library-mcp

加密貨幣Portfolio追蹤 - 支援TRON/ETH/BSC,分析持倉、收益、Gas費用

modbender/skill-library-mcp

Lead strategy with competitive analysis, strategic planning, growth roadmaps, and business portfolio management.

modbender/skill-library-mcp

Create ATS-optimized resumes and CVs with proper structure, metrics, and industry targeting.

modbender/skill-library-mcp

Native video analysis using Google Gemini API. Upload and analyze video files — describe scenes, extract text/UI, answer questions about content, transcribe speech, identify objects and actions. Use when: (1) User sends a video file and wants it analyzed, (2) Video summarization or description needed, (3) Extracting text, UI elements, or information from screen recordings, (4) Answering questions about video content, (5) Comparing multiple videos, (6) Analyzing tutorials, demos, or walkthroughs.

Skills associés