ForHosting KIT · Strumenti per sviluppatori

Bilancio materiale negli scacchi

Il calcolatore del bilancio materiale legge una posizione in notazione Forsyth–Edwards (FEN), somma il valore convenzionale dei pezzi bianchi e neri e indica quale colore è avanti e di quanti punti.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Usa la scala nota: uno per il pedone, tre per cavallo o alfiere, cinque per torre e nove per donna. Incolli il solo campo della scacchiera oppure una FEN completa per ottenere un riepilogo trasparente, verificabile pezzo per pezzo.

Legga il risultato come un quadro pratico

Il bilancio materiale consente di orientarsi rapidamente in una posizione. Il calcolatore somma i pezzi rimasti a ciascun giocatore e segnala se è avanti il Bianco, il Nero oppure se i totali coincidono. Un punto corrisponde normalmente a un pedone in più, mentre tre punti richiamano spesso un pezzo leggero. Il risultato elenca anche pedoni, cavalli, alfieri, torri, donne e re, rendendo il punteggio pienamente verificabile. Lei può vedere subito se lo scarto deriva da una torre mancante, da un cambio di donne compensato o da più scambi minori. I re compaiono nell’inventario ma valgono zero, poiché il loro valore è assoluto e non scambiabile. Consideri la risposta un inventario oggettivo, non un verdetto. Iniziativa, sicurezza del re, struttura pedonale e minacce tattiche possono contare più del vantaggio numerico.

Inserisca una posizione FEN valida

Usi il campo di disposizione dei pezzi di una stringa FEN, formato da otto traverse separate da barre. Le maiuscole indicano i pezzi bianchi e le minuscole quelli neri: P per pedone, N per cavallo, B per alfiere, R per torre, Q per donna e K per re. Le cifre rappresentano case vuote consecutive. Può anche incollare una FEN completa con tratto, arrocco, bersaglio en passant e contatori; il calcolatore legge soltanto il primo campo, perché gli altri non modificano il materiale presente. Ogni traversa deve descrivere esattamente otto case e devono esserci otto traverse. Simboli sconosciuti, righe mancanti o larghezze errate vengono respinti, mai interpretati per supposizione. Questa verifica è utile quando la posizione proviene da uno studio, un database, un sito o un programma e Lei vuole individuare una stringa danneggiata prima dell’analisi.

Comprenda il punteggio e i suoi limiti

Il calcolo adotta la scala materiale standard: pedone uno, cavallo tre, alfiere tre, torre cinque, donna nove e re zero. È una scelta volutamente semplice e deterministica. Alcuni libri e motori assegnano valori lievemente diversi, per esempio premiando l’alfiere o adattando il valore alla posizione; tali correzioni riguardano però la valutazione, non il conteggio di base. Qui due alfieri valgono sempre sei e una torre con due pedoni vale sempre sette. La differenza assoluta fra i totali diventa il margine indicato. Se i valori coincidono, il materiale risulta pari anche con pezzi di tipo diverso. Usi lo strumento per controllare cambi, preparare lezioni, verificare problemi o integrare analisi più ampie. Per giudicare correttamente una posizione, abbini l’inventario al calcolo concreto e ai fattori posizionali: un vantaggio materiale non garantisce automaticamente la vittoria.

Casi d'uso

Controlli una partita dopo un cambio

Incolli la FEN ottenuta per verificare se la sequenza ha guadagnato materiale o scambiato pezzi equivalenti.

Verifichi la posizione di un problema

Confermi che ogni pezzo previsto sia presente e che il vantaggio dichiarato corrisponda alla scacchiera.

Supporti una lezione di scacchi

Offra un riepilogo chiaro prima di discutere compenso, iniziativa, sicurezza del re o vantaggi posizionali.

Domande frequenti

Quali valori dei pezzi usa il calcolatore?

Il pedone vale 1 punto, cavallo o alfiere 3, torre 5, donna 9 e re 0 nel conteggio materiale.

Posso incollare una stringa FEN completa?

Sì. Viene letto il primo campo con la scacchiera; gli altri sono ignorati perché non cambiano il materiale attuale.

Essere avanti di materiale significa stare vincendo?

Non necessariamente. Tattica, iniziativa, sicurezza del re, struttura pedonale e compenso posizionale possono superare lo scarto numerico.

Perché il re vale zero?

Il re non può essere scambiato né catturato legalmente; compare nell’inventario, ma resta escluso dal totale convenzionale.

Cosa accade se i totali coincidono ma i pezzi differiscono?

Il risultato indica parità materiale e conserva il dettaglio per tipo affinché Lei possa valutare separatamente lo squilibrio.

Quanto costa una richiesta API?

Ogni richiesta API costa $0.002. Lo stesso calcolo deterministico può essere eseguito anche nel browser.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/hobby/chess-material-balance

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/hobby/chess-material-balance \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"position":"r3k2r/ppp2ppp/2n1bn2/3qp3/3P4/2N1PN2/PPP2PPP/R2Q1RK1 b kq - 2 10"}'

const res = await fetch("https://api.kit.forhosting.com/hobby/chess-material-balance", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "position": "r3k2r/ppp2ppp/2n1bn2/3qp3/3P4/2N1PN2/PPP2PPP/R2Q1RK1 b kq - 2 10"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/hobby/chess-material-balance",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "position": "r3k2r/ppp2ppp/2n1bn2/3qp3/3P4/2N1PN2/PPP2PPP/R2Q1RK1 b kq - 2 10"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/hobby/chess-material-balance", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"position":"r3k2r/ppp2ppp/2n1bn2/3qp3/3P4/2N1PN2/PPP2PPP/R2Q1RK1 b kq - 2 10"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"position":"r3k2r/ppp2ppp/2n1bn2/3qp3/3P4/2N1PN2/PPP2PPP/R2Q1RK1 b kq - 2 10"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/hobby/chess-material-balance", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "position": "r3k2r/ppp2ppp/2n1bn2/3qp3/3P4/2N1PN2/PPP2PPP/R2Q1RK1 b kq - 2 10"
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "hobby.chess_material_balance",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →