Все калькуляторы инвентаря, которые мне попадались, делают одно и то же: берут lowest_price по каждому предмету, складывают и показывают сумму. Только это не сумма, которую ты получишь. Это цена лота, которую видит покупатель. Продавцу приходит меньше, и не «минус процент», а по формуле.
Площадка берёт 5% Steam и 10% издателю, причём с цены лота. Поэтому «минус 15%» — неправильно, правильно «делить на 1.15». На двух с половиной тысячах разница между этими формулами — 34,78. На глаз незаметно, на десятке позиций в отчёте уже сотни.
лот 100,00 → на руки 86,96 (чтобы получить 100,00, выставлять за 115,00)
лот 115,00 → на руки 100,00 (чтобы получить 115,00, выставлять за 132,25)
лот 2 500,00 → на руки 2 173,91 (чтобы получить 2 500,00, выставлять за 2 875,00)Отсюда решение, которое определяет весь остальной код: прибыль считается от того, что придёт на кошелёк, а не от цены лота. Иначе в отчёте плюс, а на кошельке минус, и объяснять это самому себе неприятно.
Что вообще происходит с данными
Инвентарь и цены — два разных источника с разными правилами. Инвентарь отдаётся страницами и ссылается на описания по паре идентификаторов. Цены отдаются по одной штуке и упираются в лимит площадки. Между ними — база, которая хранит не «текущую цену», а все замеры.
Всё в копейках, потому что float врёт
float на ценах теряет копейку на каждой операции, а операций в отчёте сотни. Внутри — целые копейки, печать отдельно. Скучно, зато сходится.
Отдельная боль — разбор строки, которую отдаёт площадка. Выглядит она безобидно:
{"success":true,"lowest_price":"2657 руб.","volume":"69","median_price":"2577,60 руб."}В одной строке и точка, и запятая, и обе не то, чем кажутся: точка от «руб.», запятая — десятичная. Первая версия вычищала всё, кроме цифр и разделителей, и на «2577,60» получала правильное число, а на «2657» тоже правильное. Как только в строке появлялся разделитель тысяч, разбор ехал молча. В итоге сначала регулярка вырезает числовой кусок, и только потом решается, что считать десятичной запятой.
raw = text.replace("\u00a0", "").replace(" ", "")
m = re.search(r"\d[\d.,]*", raw)
if not m:
return None
num = m.group(0).rstrip(".")
if "," in num:
head, _, tail = num.rpartition(",")
num = head.replace(".", "") + "." + (tail or "0")
return int((Decimal(num) * 100).to_integral_value(ROUND_HALF_UP))Не разобрал — None, а не ноль. Ноль в ценах это ложь, которая потом всплывает в отчёте как «предмет подешевел до нуля».
Лимитер, который нельзя забыть
priceoverview уходит в 429 почти сразу, если частить. Лимитер стоит внутри клиента, а не рядом с вызывающим кодом: забыть его снаружи слишком легко, и тогда «просто посмотреть цены на сотню предметов» превращается в бан по IP.
Минимум три секунды. В прогоне видно, сколько пришлось ждать на каждом запросе и сколько занял сам запрос — это разные числа, и путать их не надо:
[1/6] AK-47 | Redline (Field-Tested) 2 657,00 лотов 69 ждали 0.0 с запрос 0.42 с
[2/6] AWP | Asiimov (Field-Tested) 10 414,92 лотов 16 ждали 2.6 с запрос 0.24 с
[3/6] M4A1-S | Printstream (Field-Tested) 16 950,82 лотов 13 ждали 2.8 с запрос 0.24 с
[4/6] USP-S | Kill Confirmed (Field-Tested) 6 150,43 лотов 13 ждали 2.8 с запрос 0.31 сИ принципиальное: на 429 клиент не говорит «цены нет». Он спит 5·n секунд и пробует снова. «Нет предложений» и «нас притормозили» — разные вещи, и если их путать, в базе останутся дырки, замаскированные под отсутствие товара. На это есть отдельный тест: первый ответ 429, второй нормальный, наружу обязан уйти второй.
Инвентарь: имя предмета лежит не там, где ищешь
Страницы по 2000 предметов, следующая — только по last_assetid, это полбеды. Главное: в assets лежат classid, instanceid и amount, а имени предмета там нет. Оно в descriptions, и склеивать надо по паре classid+instanceid, а не по assetid. Наивный парсер, который джойнит по assetid, тихо получает пустые имена и «инвентарь на ноль рублей».
И у части предметов market_hash_name в description пустой. Тогда имя достаётся из ссылки «Продать на Торговой площадке»: /market/listings/730/<urlencoded имя>. То есть после appid идёт имя, и его надо раскодировать. Первая версия брала первый сегмент после /market/listings/ и получала строку «730» — тест на этом и упал. Приятный случай, когда тест поймал не опечатку, а непонимание формата.
def market_hash_name_from_actions(actions) -> str:
for action in actions or []:
link = action.get("link") or ""
if LISTING_PREFIX not in link:
continue
tail = urlparse(link).path.split(LISTING_PREFIX, 1)[1]
parts = tail.split("/", 1)
if len(parts) < 2:
continue
return unquote(parts[1].split("/", 1)[0])
return ""Одинаковые предметы схлопываются в одну строку: ключ — имя, значение — количество и сколько из них tradable. Пустое имя выбрасывается, иначе в отчёте появится позиция «» с нулевой ценой.
История, а не последняя цена
Соблазн — хранить «текущую цену» одной строкой и перезаписывать. Так теряется единственное, ради чего трекер нужен: минимум и максимум за период. В таблице prices каждая запись — отдельный замер, последняя цена это просто ORDER BY ts DESC LIMIT 1.
CREATE TABLE prices (
id INTEGER PRIMARY KEY AUTOINCREMENT,
market_hash_name TEXT NOT NULL,
ts INTEGER NOT NULL,
lowest INTEGER,
median INTEGER,
volume INTEGER NOT NULL DEFAULT 0,
source TEXT NOT NULL DEFAULT 'priceoverview'
);
CREATE INDEX prices_item_ts ON prices(market_hash_name, ts DESC);Закупки — отдельная таблица, и средняя цена там пересчитывается, а не перезаписывается: докупил по другой цене — база изменилась. Иначе PnL считается от последней покупки, что бессмысленно. Два по 1 000 и два по 2 000 дают среднюю 1 500, а не 2 000.
Отчёт
Таблица в терминал, CSV и отдельная страница с графиком. На графике видно то, ради чего всё затевалось: серый столбик — сколько вложено, цветной — сколько придёт на руки после комиссии. Три позиции красные не для красоты.
M4A1-S | Printstream 3 18 645,90 16 950,82 −11 718,17 -20.9%
Operation Bravo Case 2 6 582,47 6 269,02 −2 262,30 -17.2%
AWP | Asiimov 2 9 894,17 10 414,92 −1 675,44 -8.5%
USP-S | Kill Confirmed 1 4 920,34 6 150,43 +427,86 +8.7%
AK-47 | Redline 1 1 859,90 2 657,00 +450,53 +24.2%
итого 9 95 671,22 80 893,70 −14 777,52 -15.4%
комиссия площадки на текущую стоимость: 12 134,07Двенадцать тысяч комиссии на девяносто пять вложенных — вот та цифра, которую калькулятор по lowest_price не показывает вообще. И это только комиссия, без учёта того, что часть предметов придётся продавать не по низшей цене, а по той, что кто-то согласится заплатить.
Закупки в прогоне демонстрационные — множители к текущей цене, чтобы в отчёте были и плюс, и минус. Так и написано в выводе. Трекер не знает, за сколько ты купил; это вводит человек командой buy.
Наблюдение за два прогона с разницей в двадцать минут: Printstream был 16 182,70, стал 16 950,82. На тринадцати лотах цена ходит на пять процентов просто потому, что кто-то снял дешёвые лоты. Любой отчёт по такой цене — оценка на момент, а не стоимость.
Что проверено, а что нет
Проверено: 17 тестов зелёные. Живой прогон против настоящей площадки: пять предметов из шести получили цену, шестой — стикер Titan Holo Katowice 2014 — вернул «нет предложений», и это корректный ответ, а не ошибка. Лимитер держит три секунды. PnL считается за вычетом комиссии. Позиция без цены не превращается в ноль прибыли, а даёт убыток всей закупки.
Не проверено, и это важнее. Разбор инвентаря я гонял только на синтетическом payload, собранном по схеме Steam. Живой публичный инвентарь не скачивал: у меня нет стим-id, который я готов светить, а придумывать «вот мой инвентарь на сорок тысяч» я не буду. Схема взята из настоящих ответов, но конкретный ответ с несколькими страницами (more_items / last_assetid) не прогонялся — там может вылезти что-нибудь на второй странице.
Второе: модель комиссии «лот / 1.15» не сверена с реальной продажей. Я не продавал предмет, чтобы посмотреть, сколько придёт на кошелёк. Формула общепринятая, но если площадка поменяет ставку, все числа поедут — лучше знать это заранее, чем из отчёта.
Третье, техническое. Скриншот окна браузера в моём окружении недоступен, поэтому картинка графика выше — не снимок экрана, а рендер канваса Chart.js через toDataURL плюс рамка и KPI-строка, достроенные в Pillow. Числа на нём настоящие (из базы), пиксели графика настоящие, а вот «это скриншот страницы» я не утверждаю.
Тесты, кстати, поймали четыре настоящие ошибки: разбор цены с точкой от «руб.», имя из ссылки вместо «730», лимитер, который на первом вызове спал положенные три секунды вместо нуля, и мою собственную арифметику в тесте (я ждал 147 800 там, где честно 147 826). Последнее — тоже полезно: ошибка была в ожидании, а не в коде, и это видно только когда считаешь руками.
Запуск
pip install "httpx>=0.28" pytest
python -m pytest tests -q # 17 passed
python make_transcript.py # transcript.txt + out/report.csv + out/chart.html
python -m cs2inv price "AK-47 | Redline (Field-Tested)"
python -m cs2inv sync items.txt
python -m cs2inv buy "AK-47 | Redline (Field-Tested)" 2 185990
python -m cs2inv report --csv out/report.csv --chart out/chart.htmlВ архиве: пакет cs2inv (money, steam, store, report, cli), три файла тестов, make_transcript.py с живым прогоном, make_images.py, README с разделом «что проверено», requirements, Dockerfile и вывод прогона в transcript.txt. Зависимость одна — httpx.
Чего здесь нет: демона, который обновляет цены сам (sync руками или из cron), авторизации в Steam для приватных инвентарей, разбора float-значений скинов и любых прогнозов. Прогнозов особенно нет — на тринадцати лотах их делать не из чего.