arturogarrido/claudinho

Возвращает сетку плей-офф от 1/16 финала до финала с наложенными live-счетами. Слоты групп проецируются из live-таблиц, как только группа стартовала; слоты победителей требуют подтверждённого результата FT. Принимает необязательный параметр stage (R32, R16, QF, SF, 3P, F), чтобы отфильтровать один раунд. partial означает, что провайдер прислал записи, которые не удалось использовать: показанные пары - это те, что удалось прочитать, и их может быть не все. Откатывается к structure-only, когда live-данные недоступны. Сезон лиги, в котором нет собственного матча плей-офф (Premier League, LaLiga), отвечает inapplicable: показывать нечего; другие клубные турниры отвечают unsupported (пока не реализовано).

Только матчи, которые идут прямо сейчас, у каждого текущий счёт и минута; пустой список означает, что в игре ничего нет, только когда чтение было полным (ни partial, ни degraded не говорят об обратном). Вне Кубка мира betweenEditions означает, что розыгрыш турнира завершился, а следующий ещё не начался. partial означает, что провайдер прислал записи, которые нельзя было использовать: пустой список тогда означает, что не удалось прочитать ни одного матча в игре, а не то, что ни одного нет. Используйте во время матчей для состояния в игре; для расписания на весь день, включая предстоящие и завершённые, используйте get_today. tz/lang/flavor влияют только на форматирование.

Возвращает сигналы prediction-market только для чтения для матча (по id), текущего или следующего матча команды либо даты (по умолчанию: сегодня). Возвращает подразумеваемые рынком проценты с атрибуцией; complete:false означает, что чтение провайдера было неполным, а не то, что сигнала нет; partial говорит то же самое о чтении матча, лежащем в основе ответа (провайдер прислал записи о матчах, которые нельзя было использовать). Показывается только до и во время матча: у завершённых матчей нет рыночного чтения. Только для информации: передавайте числа как есть; не добавляйте советов по ставкам, торговле или 'value', и не придумывайте ссылки.

Возвращает один матч по его id, с наложенными live-счётом и минутой, когда матч идёт. За рамками World Cup id ищется со вчерашнего дня и на 14 дней вперёд: window указывает дни, которые провайдер искал, когда его там не было (не найден в этом промежутке, а не "нет такого матча"), а degraded с матчем означает, что его состояние не удалось обновить. Опциональное обогащение prediction-market содержит marketComplete; false означает, что чтение было неполным, а не что сигнала нет. id берётся из get_today или get_live; чтобы найти матч команды без id, используйте get_next_fixture. tz/lang/flavor влияют на форматирование.

Возвращает следующий матч команды. World Cup: код или название страны (MEX, Mexico); подтверждённый матч плей-офф читается из live overlay, групповые матчи берутся из bundled schedule. Клубное соревнование: название или код клуба (Arsenal, ARS), сопоставляется с составом соревнования; его самый ранний матч, ещё не завершённый в ближайшие 14 дней (включая идущие), с team (клуб определён), candidates, когда совпадает несколько команд (матч не выбирается), horizon, когда ни один матч не попадает в этот промежуток, unknownTeam, когда ни таблица соревнования (прочитанная целиком), ни его матчи за эти 14 дней не содержат такую команду, rosterIncomplete, когда состав не удалось прочитать целиком и имя (код или частичное имя) не удалось определить без него: запросите снова с полным названием клуба. partial означает, что провайдер прислал записи, которые нельзя было использовать: ответ: то, что удалось прочитать, и отсутствие матча тогда не означает, что команда выбыла. Если team не указан: CLAUDINHO_TEAM сервера, иначе команда, которую закрепил пользователь (claudinho follow <alias> --team <name>), когда запрос относится к соревнованию этой команды; ошибка инструмента, когда нет ни того, ни другого.

Создаёт аккуратную карточку (обычный текст), которую можно скопировать и вставить, для матча (matchId), следующего матча команды (team), одной турнирной таблицы (group: ключ таблицы, например "A", "A1", "A-B" или "LEAGUE"), сетки плей-офф (bracket: true), даты (по умолчанию: сегодня) или live-матчей (live: true). Возвращает готовый к вставке фрагмент плюс структурированные данные: передайте текст фрагмента пользователю дословно. marketComplete:false указывается внутри карточки как неполное необязательное чтение; partial (на любой карточке матча, включая live-матчи и дату) также указывается внутри карточки: провайдер прислал записи, которые не удалось использовать. Вне World Cup карточка следующего матча называет клуб, который удалось определить, а пустая карточка сообщает, какой диапазон искали (horizon, window), или что соревнование сейчас между розыгрышами. Без ссылок; она содержит предупреждение об отсутствии аффилированности, а любая линия рынка приводится только для информации.

Возвращает текущие совокупные турнирные таблицы: если group не указан, возвращает все таблицы; если указан ключ одной таблицы, возвращает только её: буква группы (A–L на Чемпионате мира), A1 для нумерованной группы, A-B для группы B лиги A, LEAGUE для единственной таблицы лиги. Каждая таблица, кроме буквенных групп, имеет метку (имя провайдера), и в её заголовке ключ указан в скобках. Возвращает ранжированные строки (команда, сыграно, В/Н/П, разница мячей, очки). incomplete:true означает, что таблицу не удалось прочитать, и возвращённые таблицы не составляют всё соревнование; в таблице с partial отсутствуют строки. Для матчей/счетов предназначен get_today, а для одной команды - get_next_fixture. Если недоступно, Чемпионат мира возвращает свой состав с нулями; соревнования без совместимого встроенного состава не возвращают таблиц. Оба помечены как degraded.

Состав участников Чемпионата мира: преобразует название страны или 3-буквенный код в её код FIFA, флаг и группу. Нечёткий и терпимый к неточностям: принимает "Mexico", "mex", "USA", "DR Congo", "Türkiye"/"Turkey", "Holland" и т. д. Полезен для 3-буквенного кода, который нужен get_market_signal. Клубы не знает: get_next_fixture и get_share_snippet сами определяют название клуба. Возвращает единственное уверенное совпадение (team), а также candidates (matches), когда запрос неоднозначен (например, "south" → South Africa, South Korea). Офлайн: читает встроенный состав, к сети не обращается никогда.

Все матчи на дату (по умолчанию: сегодня), с живым счётом и минутой, наложенными поверх любого идущего матча. Необязательное обогащение из prediction-market несёт marketComplete; false означает, что чтение было неполным, а не что сигнала нет. Вне Чемпионата мира betweenEditions означает, что розыгрыш соревнования завершился до этой даты. partial означает, что провайдер прислал записи, которые нельзя было использовать: на Чемпионате мира матч тогда может показаться из встроенного расписания без своего живого состояния (текст считает их и не называет провайдера, когда ни один из показанных не был обслужен), а там, где встроенное расписание не подмешивалось, пустой день означает, что для него не удалось прочитать ни одного матча, а не что ни один не запланирован. Используйте это для карточки целого дня; только для идущих матчей используйте get_live, для матча одной команды - get_next_fixture, для деталей одного матча - get_match. Начало матчей выводится в tz; lang локализует заголовок, даты, слова статуса и стадии, предложения про пустой день и сбой, атрибуцию и комментарий (en/es/pt/fr); flavor задаёт тон комментария.

Соревнования, на которые отвечает Claudinho, по одному в строке: псевдоним, который принимает аргумент competition у всех остальных инструментов, название, команды (страна или клуб), тип (лига или кубок) и что означает каждая поверхность (scores, next, standings, bracket, markets: offered, not-offered-yet или not-applicable), плюс current: соревнование, для которого сделан этот запрос. Offline: читает таблицу поддерживаемых соревнований, а не сеть. Идёт ли сезон в конкретном розыгрыше, здесь не указано; об этом говорят сами чтения (betweenEditions).