mpsEx/docs.html at main · nlkli/mpsEx · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
<!DOCTYPE html>
<html lang="ru">

<head>
	<meta charset="UTF-8">
	<meta name="viewport" content="width=device-width, initial-scale=1.0">
	<link rel="icon" type="image/png" href="./icons/icon16.png">
	<link rel="stylesheet" href="base.css">
	<title>Документация</title>
	<style>
		img {
			border: solid 1px #121212;
			border-radius: 6px;
			margin-top: 8px;
		}

		pre {
			border: solid 1px #121212;
			border-radius: 6px;
			background: #C4C4C8;
			padding: 8px;
			white-space: pre-wrap;
			word-break: break-all;
		}

		code {
			word-break: break-all;
		}
	</style>
</head>

<body>
	<div style="height:28px;display: inline;"></div>
	<div style="background-color:#f2f2f2;max-width:800px;border:3px double;margin:auto;padding:14px">
		<div style="display:flex;justify-content:space-between;">
			<div>
				<img src="./icons/icon128.png" alt="logo" width="32" style="border:none;margin-right:14px;">
				<h1 style="display:inline;">Документация</h1>
			</div>
			<span style="font-size:12px;">Tue Sep 30 13:52:33 MSK 2025</span>
		</div>

		<hr>

		<h3>Ввод запроса</h3>

		<p>
			В меню расширения доступно текстовое поле для ввода запроса.
		</p>

		<img src="./assets/ex_input_menu.png" alt="Пример меню" width="360">

		<p>
			Запросом является ссылка на каталог маркетплейса (страницу магазина, категорию или результат поиска).
		</p>

		<ul>
			<li><b>Ozon</b> — можно использовать как полную, так и короткую ссылку (например: <b>/seller/0</b>).</li>
			<li><b>Wildberries</b> — требуется всегда указывать полную ссылку.</li>
		</ul>

		<p>
			Поддерживаются любые фильтры, доступные для категории.
		</p>

		<h3>Примеры корректного ввода</h3>

		<pre><code>/seller/0
/category/15500/
/category/produkty-pitaniya-9200/?sorting=new&type=58110
https://www.ozon.ru/category/elektroinstrumenty-9857/makita-26303262/?opened=brand
https://www.wildberries.ru/catalog/elektronika/smartfony-i-telefony/vse-smartfony
https://www.wildberries.ru/catalog/tsvety?page=1&sort=popular&priceU=100000%3B1000000&f368921=368922&f14177451=15000203</code></pre>

		<h3>Настройка лимита</h3>

		<p>Укажите максимальное количество товаров для парсинга. Фактическое число может немного превышать лимит, так
			как парсинг происходит постранично.</p>

		<ul>
			<li>Ozon: <=<b>12</b> товаров на странице</li>
			<li>Wildberries: <=<b>100</b> товаров на странице</li>
		</ul>

		<h3>Множественный ввод</h3>

		<p>
			Можно указать несколько каталогов одновременно:
		</p>

		<pre><code>/seller/0
/category/15500/
/category/9200/</code></pre>
		<p>
			Каждая ссылка на новой строке создает отдельный отчет.
		</p>

		<p>
			Лимит применяется к каждому каталогу отдельно.
		</p>

		<p>
			Если ссылки указаны через запятую, они будут объединены в один отчет:
		</p>
		<pre><code>/seller/0,/category/15500,/category/9200</code></pre>

		<p>
			Лимит применяется к каждому каталогу отдельно. В примере выше с лимитом 12 товаров, общее количество
			составит 36.
		</p>

		<p>
			Также можно сгруппировать ссылки с разных маркетплейсов:
		</p>
		<pre><code>https://www.ozon.ru/category/velosipedy-11002/,
https://www.wildberries.ru/catalog/sport/vidy-sporta/velosport/velosipedy</code></pre>
		<p>
			Однако такой способ не рекомендуется. В разных системах могут совпадать <code>id</code> товаров, из-за чего
			часть данных затрется. Например, если у товара на Ozon и у товара на Wildberries окажется одинаковый
			<code>id</code>, в таблицу попадет только один из них.
		</p>
		<p>
			Все описанные способы можно комбинировать для большей гибкости. Например:
		</p>
		<pre><code>https://www.ozon.ru/seller/luma-stars-201204/,https://www.ozon.ru/seller/deko-russia-11872/,https://www.ozon.ru/seller/megamaster-2901497/
https://www.wildberries.ru/catalog/elektronika/smartfony-i-telefony/vse-smartfony?page=1&sort=popular&fbrand=153038065%3B5772%3B48914%3B6049&fcolor=16777215,https://www.wildberries.ru/catalog/elektronika/noutbuki-pereferiya/noutbuki-ultrabuki?page=1&sort=popular&fbrand=5786%3B3859&fcolor=16777215</code></pre>
		<p>
			В этом случае будет создано два отчета:
		</p>
		<ul>
			<li>
				Первый отчет содержит товары трёх продавцов электроинструментов на Ozon, без фильтов.
			</li>
			<li>
				Второй отчет включает смартфоны белого цвета брендов Apple, Samsung, Realme, Google Pixel и ноутбуки
				белого цвета брендов Asus и Acer с маркетплейса Wildberries.
			</li>
		</ul>

		<p>Итог по вводу запросов:</p>

		<ul>
			<li><strong>Каждая новая строка</strong> — создает отдельный отчет</li>
			<li><strong>Ссылки через запятую</strong> — объединяют каталоги в один отчет</li>
			<li><strong>Лимит товаров</strong> — применяется к каждому каталогу отдельно</li>
		</ul>

		<hr>

		<h3>Отчет</h3>

		<p>
			После завершения парсинга откроется отчет с результатами.
		</p>

		<img src="./assets/report_log.png" alt="Лог отчета" width="300">

		<p>
			При успешном выполнении в отчете будет представлена таблица с товарами.
		</p>

		<h3>Основная таблица товаров</h3>

		<img src="./assets/report_table.png" alt="Пример таблицы отчета" width="640">

		<p>
			Таблицу можно скачать в формате CSV — это простой текстовый формат для хранения табличных данных. Файл CSV
			можно открыть в Excel или любом другом редакторе таблиц.
		</p>

		<p>
			Информацию в таблице отчета можно обновлять.
		</p>

		<h3>Таблица изменений</h3>

		<p>
			При обновлении отчета система автоматически сравнивает новые данные с предыдущими. Если цена товара
			изменилась, этот товар добавляется в отдельную таблицу изменений, что позволяет легко отслеживать динамику
			цен.
		</p>

		<img src="./assets/report_chTable.png" alt="Таблица изменений 1" width="600">
		<img src="./assets/report_chTable_2.png" alt="Пример изменений 2" width="600">
		<img src="./assets/report_chTable_3.png" alt="Пример изменений 3" width="600">

		<hr>

		<h3>Страница каталога</h3>

		<p>
			Расширение поддерживает встраивание HTML-разметки на страницы каталогов Ozon и Wildberries для прямого
			парсинга.
		</p>

		<p>
			Для парсинга каталога введите лимит и нажмите на ягодку.
		</p>

		<h3>Ozon</h3>

		<img src="./assets/oz_i.png" alt="" width="600">
		<img src="./assets/oz_is.png" alt="" width="600">

		<h3>Wildberries</h3>

		<img src="./assets/wb_ii.png" alt="" width="600">
		<img src="./assets/wb_is.png" alt="" width="600">

		<hr>

		<div style="display:flex;justify-content:space-between;margin-top:26px;">
			<a href="https://github.com/nlkli/mpsEx" target="_blank">GitHub Page</a>
			<code>mpsEx v1.1</code>
		</div>

	</div>
</body>

</html>