webscout 8.3.7__py3-none-any.whl → 2025.10.11__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of webscout might be problematic. Click here for more details.
- webscout/AIauto.py +250 -250
- webscout/AIbase.py +379 -379
- webscout/AIutel.py +60 -60
- webscout/Bard.py +1012 -1012
- webscout/Bing_search.py +417 -417
- webscout/DWEBS.py +529 -529
- webscout/Extra/Act.md +309 -309
- webscout/Extra/GitToolkit/__init__.py +10 -10
- webscout/Extra/GitToolkit/gitapi/README.md +110 -110
- webscout/Extra/GitToolkit/gitapi/__init__.py +11 -11
- webscout/Extra/GitToolkit/gitapi/repository.py +195 -195
- webscout/Extra/GitToolkit/gitapi/user.py +96 -96
- webscout/Extra/GitToolkit/gitapi/utils.py +61 -61
- webscout/Extra/YTToolkit/README.md +375 -375
- webscout/Extra/YTToolkit/YTdownloader.py +956 -956
- webscout/Extra/YTToolkit/__init__.py +2 -2
- webscout/Extra/YTToolkit/transcriber.py +475 -475
- webscout/Extra/YTToolkit/ytapi/README.md +44 -44
- webscout/Extra/YTToolkit/ytapi/__init__.py +6 -6
- webscout/Extra/YTToolkit/ytapi/channel.py +307 -307
- webscout/Extra/YTToolkit/ytapi/errors.py +13 -13
- webscout/Extra/YTToolkit/ytapi/extras.py +118 -118
- webscout/Extra/YTToolkit/ytapi/https.py +88 -88
- webscout/Extra/YTToolkit/ytapi/patterns.py +61 -61
- webscout/Extra/YTToolkit/ytapi/playlist.py +58 -58
- webscout/Extra/YTToolkit/ytapi/pool.py +7 -7
- webscout/Extra/YTToolkit/ytapi/query.py +39 -39
- webscout/Extra/YTToolkit/ytapi/stream.py +62 -62
- webscout/Extra/YTToolkit/ytapi/utils.py +62 -62
- webscout/Extra/YTToolkit/ytapi/video.py +232 -232
- webscout/Extra/autocoder/__init__.py +9 -9
- webscout/Extra/autocoder/autocoder.py +1105 -1105
- webscout/Extra/autocoder/autocoder_utiles.py +332 -332
- webscout/Extra/gguf.md +429 -429
- webscout/Extra/gguf.py +1213 -1213
- webscout/Extra/tempmail/README.md +487 -487
- webscout/Extra/tempmail/__init__.py +27 -27
- webscout/Extra/tempmail/async_utils.py +140 -140
- webscout/Extra/tempmail/base.py +160 -160
- webscout/Extra/tempmail/cli.py +186 -186
- webscout/Extra/tempmail/emailnator.py +84 -84
- webscout/Extra/tempmail/mail_tm.py +360 -360
- webscout/Extra/tempmail/temp_mail_io.py +291 -291
- webscout/Extra/weather.md +281 -281
- webscout/Extra/weather.py +193 -193
- webscout/Litlogger/README.md +10 -10
- webscout/Litlogger/__init__.py +15 -15
- webscout/Litlogger/formats.py +13 -13
- webscout/Litlogger/handlers.py +121 -121
- webscout/Litlogger/levels.py +13 -13
- webscout/Litlogger/logger.py +134 -134
- webscout/Provider/AISEARCH/Perplexity.py +332 -332
- webscout/Provider/AISEARCH/README.md +279 -279
- webscout/Provider/AISEARCH/__init__.py +16 -1
- webscout/Provider/AISEARCH/felo_search.py +206 -206
- webscout/Provider/AISEARCH/genspark_search.py +323 -323
- webscout/Provider/AISEARCH/hika_search.py +185 -185
- webscout/Provider/AISEARCH/iask_search.py +410 -410
- webscout/Provider/AISEARCH/monica_search.py +219 -219
- webscout/Provider/AISEARCH/scira_search.py +316 -316
- webscout/Provider/AISEARCH/stellar_search.py +177 -177
- webscout/Provider/AISEARCH/webpilotai_search.py +255 -255
- webscout/Provider/Aitopia.py +314 -314
- webscout/Provider/Apriel.py +306 -0
- webscout/Provider/ChatGPTClone.py +236 -236
- webscout/Provider/ChatSandbox.py +343 -343
- webscout/Provider/Cloudflare.py +324 -324
- webscout/Provider/Cohere.py +208 -208
- webscout/Provider/Deepinfra.py +370 -366
- webscout/Provider/ExaAI.py +260 -260
- webscout/Provider/ExaChat.py +308 -308
- webscout/Provider/Flowith.py +221 -221
- webscout/Provider/GMI.py +293 -0
- webscout/Provider/Gemini.py +164 -164
- webscout/Provider/GeminiProxy.py +167 -167
- webscout/Provider/GithubChat.py +371 -372
- webscout/Provider/Groq.py +800 -800
- webscout/Provider/HeckAI.py +383 -383
- webscout/Provider/Jadve.py +282 -282
- webscout/Provider/K2Think.py +307 -307
- webscout/Provider/Koboldai.py +205 -205
- webscout/Provider/LambdaChat.py +423 -423
- webscout/Provider/Nemotron.py +244 -244
- webscout/Provider/Netwrck.py +248 -248
- webscout/Provider/OLLAMA.py +395 -395
- webscout/Provider/OPENAI/Cloudflare.py +393 -393
- webscout/Provider/OPENAI/FalconH1.py +451 -451
- webscout/Provider/OPENAI/FreeGemini.py +296 -296
- webscout/Provider/OPENAI/K2Think.py +431 -431
- webscout/Provider/OPENAI/NEMOTRON.py +240 -240
- webscout/Provider/OPENAI/PI.py +427 -427
- webscout/Provider/OPENAI/README.md +959 -959
- webscout/Provider/OPENAI/TogetherAI.py +345 -345
- webscout/Provider/OPENAI/TwoAI.py +465 -465
- webscout/Provider/OPENAI/__init__.py +33 -18
- webscout/Provider/OPENAI/base.py +248 -248
- webscout/Provider/OPENAI/chatglm.py +528 -0
- webscout/Provider/OPENAI/chatgpt.py +592 -592
- webscout/Provider/OPENAI/chatgptclone.py +521 -521
- webscout/Provider/OPENAI/chatsandbox.py +202 -202
- webscout/Provider/OPENAI/deepinfra.py +318 -314
- webscout/Provider/OPENAI/e2b.py +1665 -1665
- webscout/Provider/OPENAI/exaai.py +420 -420
- webscout/Provider/OPENAI/exachat.py +452 -452
- webscout/Provider/OPENAI/friendli.py +232 -232
- webscout/Provider/OPENAI/{refact.py → gmi.py} +324 -274
- webscout/Provider/OPENAI/groq.py +364 -364
- webscout/Provider/OPENAI/heckai.py +314 -314
- webscout/Provider/OPENAI/llmchatco.py +337 -337
- webscout/Provider/OPENAI/netwrck.py +355 -355
- webscout/Provider/OPENAI/oivscode.py +290 -290
- webscout/Provider/OPENAI/opkfc.py +518 -518
- webscout/Provider/OPENAI/pydantic_imports.py +1 -1
- webscout/Provider/OPENAI/scirachat.py +535 -535
- webscout/Provider/OPENAI/sonus.py +308 -308
- webscout/Provider/OPENAI/standardinput.py +442 -442
- webscout/Provider/OPENAI/textpollinations.py +340 -340
- webscout/Provider/OPENAI/toolbaz.py +419 -416
- webscout/Provider/OPENAI/typefully.py +362 -362
- webscout/Provider/OPENAI/utils.py +295 -295
- webscout/Provider/OPENAI/venice.py +436 -436
- webscout/Provider/OPENAI/wisecat.py +387 -387
- webscout/Provider/OPENAI/writecream.py +166 -166
- webscout/Provider/OPENAI/x0gpt.py +378 -378
- webscout/Provider/OPENAI/yep.py +389 -389
- webscout/Provider/OpenGPT.py +230 -230
- webscout/Provider/Openai.py +243 -243
- webscout/Provider/PI.py +405 -405
- webscout/Provider/Perplexitylabs.py +430 -430
- webscout/Provider/QwenLM.py +272 -272
- webscout/Provider/STT/__init__.py +16 -1
- webscout/Provider/Sambanova.py +257 -257
- webscout/Provider/StandardInput.py +309 -309
- webscout/Provider/TTI/README.md +82 -82
- webscout/Provider/TTI/__init__.py +33 -18
- webscout/Provider/TTI/aiarta.py +413 -413
- webscout/Provider/TTI/base.py +136 -136
- webscout/Provider/TTI/bing.py +243 -243
- webscout/Provider/TTI/gpt1image.py +149 -149
- webscout/Provider/TTI/imagen.py +196 -196
- webscout/Provider/TTI/infip.py +211 -211
- webscout/Provider/TTI/magicstudio.py +232 -232
- webscout/Provider/TTI/monochat.py +219 -219
- webscout/Provider/TTI/piclumen.py +214 -214
- webscout/Provider/TTI/pixelmuse.py +232 -232
- webscout/Provider/TTI/pollinations.py +232 -232
- webscout/Provider/TTI/together.py +288 -288
- webscout/Provider/TTI/utils.py +12 -12
- webscout/Provider/TTI/venice.py +367 -367
- webscout/Provider/TTS/README.md +192 -192
- webscout/Provider/TTS/__init__.py +33 -18
- webscout/Provider/TTS/parler.py +110 -110
- webscout/Provider/TTS/streamElements.py +333 -333
- webscout/Provider/TTS/utils.py +280 -280
- webscout/Provider/TeachAnything.py +237 -237
- webscout/Provider/TextPollinationsAI.py +310 -310
- webscout/Provider/TogetherAI.py +356 -356
- webscout/Provider/TwoAI.py +312 -312
- webscout/Provider/TypliAI.py +311 -311
- webscout/Provider/UNFINISHED/ChatHub.py +208 -208
- webscout/Provider/UNFINISHED/ChutesAI.py +313 -313
- webscout/Provider/UNFINISHED/GizAI.py +294 -294
- webscout/Provider/UNFINISHED/Marcus.py +198 -198
- webscout/Provider/UNFINISHED/Qodo.py +477 -477
- webscout/Provider/UNFINISHED/VercelAIGateway.py +338 -338
- webscout/Provider/UNFINISHED/XenAI.py +324 -324
- webscout/Provider/UNFINISHED/Youchat.py +330 -330
- webscout/Provider/UNFINISHED/liner.py +334 -0
- webscout/Provider/UNFINISHED/liner_api_request.py +262 -262
- webscout/Provider/UNFINISHED/puterjs.py +634 -634
- webscout/Provider/UNFINISHED/samurai.py +223 -223
- webscout/Provider/UNFINISHED/test_lmarena.py +119 -119
- webscout/Provider/Venice.py +250 -250
- webscout/Provider/VercelAI.py +256 -256
- webscout/Provider/WiseCat.py +231 -231
- webscout/Provider/WrDoChat.py +366 -366
- webscout/Provider/__init__.py +33 -18
- webscout/Provider/ai4chat.py +174 -174
- webscout/Provider/akashgpt.py +331 -331
- webscout/Provider/cerebras.py +446 -446
- webscout/Provider/chatglm.py +394 -301
- webscout/Provider/cleeai.py +211 -211
- webscout/Provider/elmo.py +282 -282
- webscout/Provider/geminiapi.py +208 -208
- webscout/Provider/granite.py +261 -261
- webscout/Provider/hermes.py +263 -263
- webscout/Provider/julius.py +223 -223
- webscout/Provider/learnfastai.py +309 -309
- webscout/Provider/llama3mitril.py +214 -214
- webscout/Provider/llmchat.py +243 -243
- webscout/Provider/llmchatco.py +290 -290
- webscout/Provider/meta.py +801 -801
- webscout/Provider/oivscode.py +309 -309
- webscout/Provider/scira_chat.py +383 -383
- webscout/Provider/searchchat.py +292 -292
- webscout/Provider/sonus.py +258 -258
- webscout/Provider/toolbaz.py +370 -367
- webscout/Provider/turboseek.py +273 -273
- webscout/Provider/typefully.py +207 -207
- webscout/Provider/yep.py +372 -372
- webscout/__init__.py +30 -31
- webscout/__main__.py +5 -5
- webscout/auth/api_key_manager.py +189 -189
- webscout/auth/config.py +175 -175
- webscout/auth/models.py +185 -185
- webscout/auth/routes.py +664 -664
- webscout/auth/simple_logger.py +236 -236
- webscout/cli.py +523 -523
- webscout/conversation.py +438 -438
- webscout/exceptions.py +361 -361
- webscout/litagent/Readme.md +298 -298
- webscout/litagent/__init__.py +28 -28
- webscout/litagent/agent.py +581 -581
- webscout/litagent/constants.py +59 -59
- webscout/litprinter/__init__.py +58 -58
- webscout/models.py +181 -181
- webscout/optimizers.py +419 -419
- webscout/prompt_manager.py +288 -288
- webscout/sanitize.py +1078 -1078
- webscout/scout/README.md +401 -401
- webscout/scout/__init__.py +8 -8
- webscout/scout/core/__init__.py +6 -6
- webscout/scout/core/crawler.py +297 -297
- webscout/scout/core/scout.py +706 -706
- webscout/scout/core/search_result.py +95 -95
- webscout/scout/core/text_analyzer.py +62 -62
- webscout/scout/core/text_utils.py +277 -277
- webscout/scout/core/web_analyzer.py +51 -51
- webscout/scout/element.py +599 -599
- webscout/scout/parsers/__init__.py +69 -69
- webscout/scout/parsers/html5lib_parser.py +172 -172
- webscout/scout/parsers/html_parser.py +236 -236
- webscout/scout/parsers/lxml_parser.py +178 -178
- webscout/scout/utils.py +37 -37
- webscout/swiftcli/Readme.md +323 -323
- webscout/swiftcli/__init__.py +95 -95
- webscout/swiftcli/core/__init__.py +7 -7
- webscout/swiftcli/core/cli.py +308 -308
- webscout/swiftcli/core/context.py +104 -104
- webscout/swiftcli/core/group.py +241 -241
- webscout/swiftcli/decorators/__init__.py +28 -28
- webscout/swiftcli/decorators/command.py +221 -221
- webscout/swiftcli/decorators/options.py +220 -220
- webscout/swiftcli/decorators/output.py +302 -302
- webscout/swiftcli/exceptions.py +21 -21
- webscout/swiftcli/plugins/__init__.py +9 -9
- webscout/swiftcli/plugins/base.py +135 -135
- webscout/swiftcli/plugins/manager.py +269 -269
- webscout/swiftcli/utils/__init__.py +59 -59
- webscout/swiftcli/utils/formatting.py +252 -252
- webscout/swiftcli/utils/parsing.py +267 -267
- webscout/update_checker.py +117 -117
- webscout/version.py +1 -1
- webscout/webscout_search.py +1183 -1183
- webscout/webscout_search_async.py +649 -649
- webscout/yep_search.py +346 -346
- webscout/zeroart/README.md +89 -89
- webscout/zeroart/__init__.py +134 -134
- webscout/zeroart/base.py +66 -66
- webscout/zeroart/effects.py +100 -100
- webscout/zeroart/fonts.py +1238 -1238
- {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/METADATA +937 -937
- webscout-2025.10.11.dist-info/RECORD +300 -0
- webscout/Provider/AISEARCH/DeepFind.py +0 -254
- webscout/Provider/OPENAI/Qwen3.py +0 -303
- webscout/Provider/OPENAI/qodo.py +0 -630
- webscout/Provider/OPENAI/xenai.py +0 -514
- webscout/tempid.py +0 -134
- webscout-8.3.7.dist-info/RECORD +0 -301
- {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/WHEEL +0 -0
- {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/entry_points.txt +0 -0
- {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/licenses/LICENSE.md +0 -0
- {webscout-8.3.7.dist-info → webscout-2025.10.11.dist-info}/top_level.txt +0 -0
|
@@ -1,263 +1,263 @@
|
|
|
1
|
-
import requests
|
|
2
|
-
import json
|
|
3
|
-
from typing import Dict, Optional, Generator, Union, Any
|
|
4
|
-
from uuid import uuid4
|
|
5
|
-
import time
|
|
6
|
-
import base64
|
|
7
|
-
import random
|
|
8
|
-
|
|
9
|
-
from webscout.AIbase import AISearch
|
|
10
|
-
from webscout import exceptions
|
|
11
|
-
from webscout import LitAgent
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
class Response:
|
|
15
|
-
"""A wrapper class for Liner API responses.
|
|
16
|
-
|
|
17
|
-
This class automatically converts response objects to their text representation
|
|
18
|
-
when printed or converted to string.
|
|
19
|
-
|
|
20
|
-
Attributes:
|
|
21
|
-
text (str): The text content of the response
|
|
22
|
-
|
|
23
|
-
Example:
|
|
24
|
-
>>> response = Response("Hello, world!")
|
|
25
|
-
>>> print(response)
|
|
26
|
-
Hello, world!
|
|
27
|
-
>>> str(response)
|
|
28
|
-
'Hello, world!'
|
|
29
|
-
"""
|
|
30
|
-
def __init__(self, text: str):
|
|
31
|
-
self.text = text
|
|
32
|
-
|
|
33
|
-
def __str__(self):
|
|
34
|
-
return self.text
|
|
35
|
-
|
|
36
|
-
def __repr__(self):
|
|
37
|
-
return self.text
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
class Liner(AISearch):
|
|
41
|
-
"""A class to interact with the Liner AI search API.
|
|
42
|
-
|
|
43
|
-
Liner provides a powerful search interface that returns AI-generated responses
|
|
44
|
-
based on web content. It supports both streaming and non-streaming responses.
|
|
45
|
-
|
|
46
|
-
Basic Usage:
|
|
47
|
-
>>> from webscout import Liner
|
|
48
|
-
>>> ai = Liner(cookies_path="cookies.json")
|
|
49
|
-
>>> # Non-streaming example
|
|
50
|
-
>>> response = ai.search("What is Python?")
|
|
51
|
-
>>> print(response)
|
|
52
|
-
Python is a high-level programming language...
|
|
53
|
-
|
|
54
|
-
>>> # Streaming example
|
|
55
|
-
>>> for chunk in ai.search("Tell me about AI", stream=True):
|
|
56
|
-
... print(chunk, end="", flush=True)
|
|
57
|
-
Artificial Intelligence is...
|
|
58
|
-
|
|
59
|
-
>>> # Raw response format
|
|
60
|
-
>>> for chunk in ai.search("Hello", stream=True, raw=True):
|
|
61
|
-
... print(chunk)
|
|
62
|
-
{'text': 'Hello'}
|
|
63
|
-
{'text': ' there!'}
|
|
64
|
-
|
|
65
|
-
Args:
|
|
66
|
-
cookies_path (str): Path to the cookies JSON file
|
|
67
|
-
timeout (int, optional): Request timeout in seconds. Defaults to 30.
|
|
68
|
-
proxies (dict, optional): Proxy configuration for requests. Defaults to None.
|
|
69
|
-
deep_search (bool, optional): Enable deep research mode. Defaults to True.
|
|
70
|
-
reasoning_mode (bool, optional): Enable reasoning mode. Defaults to False.
|
|
71
|
-
"""
|
|
72
|
-
|
|
73
|
-
def __init__(
|
|
74
|
-
self,
|
|
75
|
-
cookies_path: str,
|
|
76
|
-
timeout: int = 600,
|
|
77
|
-
proxies: Optional[dict] = None,
|
|
78
|
-
deep_search: bool = True,
|
|
79
|
-
reasoning_mode: bool = False,
|
|
80
|
-
):
|
|
81
|
-
"""Initialize the Liner API client.
|
|
82
|
-
|
|
83
|
-
Args:
|
|
84
|
-
cookies_path (str): Path to the cookies JSON file
|
|
85
|
-
timeout (int, optional): Request timeout in seconds. Defaults to 30.
|
|
86
|
-
proxies (dict, optional): Proxy configuration for requests. Defaults to None.
|
|
87
|
-
deep_search (bool, optional): Enable deep research mode. Defaults to True.
|
|
88
|
-
reasoning_mode (bool, optional): Enable reasoning mode. Defaults to False.
|
|
89
|
-
"""
|
|
90
|
-
self.session = requests.Session()
|
|
91
|
-
self.chat_endpoint = "https://getliner.com/lisa/v1/answer"
|
|
92
|
-
self.stream_chunk_size = 64
|
|
93
|
-
self.timeout = timeout
|
|
94
|
-
self.last_response = {}
|
|
95
|
-
self.cookies_path = cookies_path
|
|
96
|
-
self.deep_search = deep_search
|
|
97
|
-
self.reasoning_mode = reasoning_mode
|
|
98
|
-
|
|
99
|
-
# Generate random IDs
|
|
100
|
-
self.space_id = random.randint(10000000, 99999999)
|
|
101
|
-
self.thread_id = random.randint(10000000, 99999999)
|
|
102
|
-
self.user_message_id = random.randint(100000000, 999999999)
|
|
103
|
-
self.user_id = random.randint(1000000, 9999999)
|
|
104
|
-
|
|
105
|
-
self.headers = {
|
|
106
|
-
"accept": "text/event-stream",
|
|
107
|
-
"accept-encoding": "gzip, deflate, br, zstd",
|
|
108
|
-
"accept-language": "en-US,en;q=0.9,en-IN;q=0.8",
|
|
109
|
-
"content-type": "application/json",
|
|
110
|
-
"dnt": "1",
|
|
111
|
-
"origin": "https://getliner.com",
|
|
112
|
-
"referer": f"https://getliner.com/search/s/{self.space_id}/t/t_{uuid4()}?mode=temp&msg-entry-type=main&build-id=kwJaNRjnCKjh7PijZgqV2",
|
|
113
|
-
"sec-ch-ua": '"Chromium";v="134", "Not:A-Brand";v="24", "Microsoft Edge";v="134"',
|
|
114
|
-
"sec-ch-ua-mobile": "?0",
|
|
115
|
-
"sec-ch-ua-platform": '"Windows"',
|
|
116
|
-
"sec-fetch-dest": "empty",
|
|
117
|
-
"sec-fetch-mode": "cors",
|
|
118
|
-
"sec-fetch-site": "same-origin",
|
|
119
|
-
"sec-gpc": "1",
|
|
120
|
-
"user-agent": LitAgent().random()
|
|
121
|
-
}
|
|
122
|
-
|
|
123
|
-
# Load cookies from JSON file
|
|
124
|
-
self.cookies = self._load_cookies()
|
|
125
|
-
if not self.cookies:
|
|
126
|
-
raise ValueError("Failed to load cookies from file")
|
|
127
|
-
|
|
128
|
-
# Set headers and cookies in session
|
|
129
|
-
self.session.headers.update(self.headers)
|
|
130
|
-
self.session.cookies.update(self.cookies)
|
|
131
|
-
self.session.proxies = proxies or {}
|
|
132
|
-
|
|
133
|
-
def _load_cookies(self) -> Optional[Dict[str, str]]:
|
|
134
|
-
"""Load cookies from a JSON file.
|
|
135
|
-
|
|
136
|
-
Returns:
|
|
137
|
-
Optional[Dict[str, str]]: Dictionary of cookies if successful, None otherwise
|
|
138
|
-
"""
|
|
139
|
-
try:
|
|
140
|
-
with open(self.cookies_path, 'r') as f:
|
|
141
|
-
cookies_data = json.load(f)
|
|
142
|
-
return {cookie['name']: cookie['value'] for cookie in cookies_data}
|
|
143
|
-
except FileNotFoundError:
|
|
144
|
-
print(f"Error: {self.cookies_path} file not found!")
|
|
145
|
-
return None
|
|
146
|
-
except json.JSONDecodeError:
|
|
147
|
-
print(f"Error: Invalid JSON format in {self.cookies_path}!")
|
|
148
|
-
return None
|
|
149
|
-
except KeyError:
|
|
150
|
-
print(f"Error: Invalid cookie format in {self.cookies_path}! Each cookie must have 'name' and 'value' keys.")
|
|
151
|
-
return None
|
|
152
|
-
|
|
153
|
-
def search(
|
|
154
|
-
self,
|
|
155
|
-
prompt: str,
|
|
156
|
-
stream: bool = False,
|
|
157
|
-
raw: bool = False,
|
|
158
|
-
) -> Union[Response, Generator[Union[Dict[str, str], Response], None, None]]:
|
|
159
|
-
"""Search using the Liner API and get AI-generated responses.
|
|
160
|
-
|
|
161
|
-
Args:
|
|
162
|
-
prompt (str): The search query or prompt to send to the API.
|
|
163
|
-
stream (bool, optional): If True, yields response chunks as they arrive.
|
|
164
|
-
If False, returns complete response. Defaults to False.
|
|
165
|
-
raw (bool, optional): If True, returns raw response dictionaries with 'text' key.
|
|
166
|
-
If False, returns Response objects that convert to text automatically.
|
|
167
|
-
Defaults to False.
|
|
168
|
-
|
|
169
|
-
Returns:
|
|
170
|
-
Union[Response, Generator[Union[Dict[str, str], Response], None, None]]:
|
|
171
|
-
- If stream=False: Returns complete response
|
|
172
|
-
- If stream=True: Yields response chunks as they arrive
|
|
173
|
-
|
|
174
|
-
Raises:
|
|
175
|
-
APIConnectionError: If the API request fails
|
|
176
|
-
"""
|
|
177
|
-
payload = {
|
|
178
|
-
"spaceId": self.space_id,
|
|
179
|
-
"threadId": self.thread_id,
|
|
180
|
-
"userMessageId": self.user_message_id,
|
|
181
|
-
"userId": self.user_id,
|
|
182
|
-
"query": prompt,
|
|
183
|
-
"agentId": "liner",
|
|
184
|
-
"platform": "web",
|
|
185
|
-
"regenerate": False,
|
|
186
|
-
"showReferenceChunks": True,
|
|
187
|
-
"mode": "general",
|
|
188
|
-
"answerMode": "search",
|
|
189
|
-
"isReasoningMode": self.reasoning_mode,
|
|
190
|
-
"experimentId": random.randint(80, 90),
|
|
191
|
-
"modelType": "liner",
|
|
192
|
-
"experimentVariants": [],
|
|
193
|
-
"isDeepResearchMode": self.deep_search
|
|
194
|
-
}
|
|
195
|
-
|
|
196
|
-
def for_stream():
|
|
197
|
-
try:
|
|
198
|
-
with self.session.post(
|
|
199
|
-
self.chat_endpoint,
|
|
200
|
-
json=payload,
|
|
201
|
-
stream=True,
|
|
202
|
-
timeout=self.timeout,
|
|
203
|
-
) as response:
|
|
204
|
-
if not response.ok:
|
|
205
|
-
raise exceptions.APIConnectionError(
|
|
206
|
-
f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}"
|
|
207
|
-
)
|
|
208
|
-
|
|
209
|
-
current_reasoning = ""
|
|
210
|
-
current_answer = ""
|
|
211
|
-
|
|
212
|
-
for line in response.iter_lines(decode_unicode=True):
|
|
213
|
-
if line == "event:finish_answer":
|
|
214
|
-
break
|
|
215
|
-
|
|
216
|
-
if line.startswith('data:'):
|
|
217
|
-
try:
|
|
218
|
-
data = json.loads(line[5:]) # Remove 'data:' prefix
|
|
219
|
-
|
|
220
|
-
# Handle reasoning updates if enabled
|
|
221
|
-
if self.reasoning_mode and 'reasoning' in data:
|
|
222
|
-
current_reasoning += data['reasoning']
|
|
223
|
-
if raw:
|
|
224
|
-
yield {"text": data['reasoning']}
|
|
225
|
-
else:
|
|
226
|
-
yield Response(data['reasoning'])
|
|
227
|
-
|
|
228
|
-
# Handle answer updates
|
|
229
|
-
if 'answer' in data:
|
|
230
|
-
current_answer += data['answer']
|
|
231
|
-
if raw:
|
|
232
|
-
yield {"text": data['answer']}
|
|
233
|
-
else:
|
|
234
|
-
yield Response(data['answer'])
|
|
235
|
-
|
|
236
|
-
except json.JSONDecodeError:
|
|
237
|
-
continue
|
|
238
|
-
|
|
239
|
-
except requests.exceptions.RequestException as e:
|
|
240
|
-
raise exceptions.APIConnectionError(f"Request failed: {e}")
|
|
241
|
-
|
|
242
|
-
def for_non_stream():
|
|
243
|
-
full_response = ""
|
|
244
|
-
for chunk in for_stream():
|
|
245
|
-
if raw:
|
|
246
|
-
yield chunk
|
|
247
|
-
else:
|
|
248
|
-
full_response += str(chunk)
|
|
249
|
-
|
|
250
|
-
if not raw:
|
|
251
|
-
self.last_response = Response(full_response)
|
|
252
|
-
return self.last_response
|
|
253
|
-
|
|
254
|
-
return for_stream() if stream else for_non_stream()
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
if __name__ == "__main__":
|
|
258
|
-
from rich import print
|
|
259
|
-
|
|
260
|
-
ai = Liner(cookies_path="cookies.json")
|
|
261
|
-
response = ai.search(input(">>> "), stream=True, raw=False)
|
|
262
|
-
for chunk in response:
|
|
1
|
+
import requests
|
|
2
|
+
import json
|
|
3
|
+
from typing import Dict, Optional, Generator, Union, Any
|
|
4
|
+
from uuid import uuid4
|
|
5
|
+
import time
|
|
6
|
+
import base64
|
|
7
|
+
import random
|
|
8
|
+
|
|
9
|
+
from webscout.AIbase import AISearch
|
|
10
|
+
from webscout import exceptions
|
|
11
|
+
from webscout import LitAgent
|
|
12
|
+
|
|
13
|
+
|
|
14
|
+
class Response:
|
|
15
|
+
"""A wrapper class for Liner API responses.
|
|
16
|
+
|
|
17
|
+
This class automatically converts response objects to their text representation
|
|
18
|
+
when printed or converted to string.
|
|
19
|
+
|
|
20
|
+
Attributes:
|
|
21
|
+
text (str): The text content of the response
|
|
22
|
+
|
|
23
|
+
Example:
|
|
24
|
+
>>> response = Response("Hello, world!")
|
|
25
|
+
>>> print(response)
|
|
26
|
+
Hello, world!
|
|
27
|
+
>>> str(response)
|
|
28
|
+
'Hello, world!'
|
|
29
|
+
"""
|
|
30
|
+
def __init__(self, text: str):
|
|
31
|
+
self.text = text
|
|
32
|
+
|
|
33
|
+
def __str__(self):
|
|
34
|
+
return self.text
|
|
35
|
+
|
|
36
|
+
def __repr__(self):
|
|
37
|
+
return self.text
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
class Liner(AISearch):
|
|
41
|
+
"""A class to interact with the Liner AI search API.
|
|
42
|
+
|
|
43
|
+
Liner provides a powerful search interface that returns AI-generated responses
|
|
44
|
+
based on web content. It supports both streaming and non-streaming responses.
|
|
45
|
+
|
|
46
|
+
Basic Usage:
|
|
47
|
+
>>> from webscout import Liner
|
|
48
|
+
>>> ai = Liner(cookies_path="cookies.json")
|
|
49
|
+
>>> # Non-streaming example
|
|
50
|
+
>>> response = ai.search("What is Python?")
|
|
51
|
+
>>> print(response)
|
|
52
|
+
Python is a high-level programming language...
|
|
53
|
+
|
|
54
|
+
>>> # Streaming example
|
|
55
|
+
>>> for chunk in ai.search("Tell me about AI", stream=True):
|
|
56
|
+
... print(chunk, end="", flush=True)
|
|
57
|
+
Artificial Intelligence is...
|
|
58
|
+
|
|
59
|
+
>>> # Raw response format
|
|
60
|
+
>>> for chunk in ai.search("Hello", stream=True, raw=True):
|
|
61
|
+
... print(chunk)
|
|
62
|
+
{'text': 'Hello'}
|
|
63
|
+
{'text': ' there!'}
|
|
64
|
+
|
|
65
|
+
Args:
|
|
66
|
+
cookies_path (str): Path to the cookies JSON file
|
|
67
|
+
timeout (int, optional): Request timeout in seconds. Defaults to 30.
|
|
68
|
+
proxies (dict, optional): Proxy configuration for requests. Defaults to None.
|
|
69
|
+
deep_search (bool, optional): Enable deep research mode. Defaults to True.
|
|
70
|
+
reasoning_mode (bool, optional): Enable reasoning mode. Defaults to False.
|
|
71
|
+
"""
|
|
72
|
+
|
|
73
|
+
def __init__(
|
|
74
|
+
self,
|
|
75
|
+
cookies_path: str,
|
|
76
|
+
timeout: int = 600,
|
|
77
|
+
proxies: Optional[dict] = None,
|
|
78
|
+
deep_search: bool = True,
|
|
79
|
+
reasoning_mode: bool = False,
|
|
80
|
+
):
|
|
81
|
+
"""Initialize the Liner API client.
|
|
82
|
+
|
|
83
|
+
Args:
|
|
84
|
+
cookies_path (str): Path to the cookies JSON file
|
|
85
|
+
timeout (int, optional): Request timeout in seconds. Defaults to 30.
|
|
86
|
+
proxies (dict, optional): Proxy configuration for requests. Defaults to None.
|
|
87
|
+
deep_search (bool, optional): Enable deep research mode. Defaults to True.
|
|
88
|
+
reasoning_mode (bool, optional): Enable reasoning mode. Defaults to False.
|
|
89
|
+
"""
|
|
90
|
+
self.session = requests.Session()
|
|
91
|
+
self.chat_endpoint = "https://getliner.com/lisa/v1/answer"
|
|
92
|
+
self.stream_chunk_size = 64
|
|
93
|
+
self.timeout = timeout
|
|
94
|
+
self.last_response = {}
|
|
95
|
+
self.cookies_path = cookies_path
|
|
96
|
+
self.deep_search = deep_search
|
|
97
|
+
self.reasoning_mode = reasoning_mode
|
|
98
|
+
|
|
99
|
+
# Generate random IDs
|
|
100
|
+
self.space_id = random.randint(10000000, 99999999)
|
|
101
|
+
self.thread_id = random.randint(10000000, 99999999)
|
|
102
|
+
self.user_message_id = random.randint(100000000, 999999999)
|
|
103
|
+
self.user_id = random.randint(1000000, 9999999)
|
|
104
|
+
|
|
105
|
+
self.headers = {
|
|
106
|
+
"accept": "text/event-stream",
|
|
107
|
+
"accept-encoding": "gzip, deflate, br, zstd",
|
|
108
|
+
"accept-language": "en-US,en;q=0.9,en-IN;q=0.8",
|
|
109
|
+
"content-type": "application/json",
|
|
110
|
+
"dnt": "1",
|
|
111
|
+
"origin": "https://getliner.com",
|
|
112
|
+
"referer": f"https://getliner.com/search/s/{self.space_id}/t/t_{uuid4()}?mode=temp&msg-entry-type=main&build-id=kwJaNRjnCKjh7PijZgqV2",
|
|
113
|
+
"sec-ch-ua": '"Chromium";v="134", "Not:A-Brand";v="24", "Microsoft Edge";v="134"',
|
|
114
|
+
"sec-ch-ua-mobile": "?0",
|
|
115
|
+
"sec-ch-ua-platform": '"Windows"',
|
|
116
|
+
"sec-fetch-dest": "empty",
|
|
117
|
+
"sec-fetch-mode": "cors",
|
|
118
|
+
"sec-fetch-site": "same-origin",
|
|
119
|
+
"sec-gpc": "1",
|
|
120
|
+
"user-agent": LitAgent().random()
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
# Load cookies from JSON file
|
|
124
|
+
self.cookies = self._load_cookies()
|
|
125
|
+
if not self.cookies:
|
|
126
|
+
raise ValueError("Failed to load cookies from file")
|
|
127
|
+
|
|
128
|
+
# Set headers and cookies in session
|
|
129
|
+
self.session.headers.update(self.headers)
|
|
130
|
+
self.session.cookies.update(self.cookies)
|
|
131
|
+
self.session.proxies = proxies or {}
|
|
132
|
+
|
|
133
|
+
def _load_cookies(self) -> Optional[Dict[str, str]]:
|
|
134
|
+
"""Load cookies from a JSON file.
|
|
135
|
+
|
|
136
|
+
Returns:
|
|
137
|
+
Optional[Dict[str, str]]: Dictionary of cookies if successful, None otherwise
|
|
138
|
+
"""
|
|
139
|
+
try:
|
|
140
|
+
with open(self.cookies_path, 'r') as f:
|
|
141
|
+
cookies_data = json.load(f)
|
|
142
|
+
return {cookie['name']: cookie['value'] for cookie in cookies_data}
|
|
143
|
+
except FileNotFoundError:
|
|
144
|
+
print(f"Error: {self.cookies_path} file not found!")
|
|
145
|
+
return None
|
|
146
|
+
except json.JSONDecodeError:
|
|
147
|
+
print(f"Error: Invalid JSON format in {self.cookies_path}!")
|
|
148
|
+
return None
|
|
149
|
+
except KeyError:
|
|
150
|
+
print(f"Error: Invalid cookie format in {self.cookies_path}! Each cookie must have 'name' and 'value' keys.")
|
|
151
|
+
return None
|
|
152
|
+
|
|
153
|
+
def search(
|
|
154
|
+
self,
|
|
155
|
+
prompt: str,
|
|
156
|
+
stream: bool = False,
|
|
157
|
+
raw: bool = False,
|
|
158
|
+
) -> Union[Response, Generator[Union[Dict[str, str], Response], None, None]]:
|
|
159
|
+
"""Search using the Liner API and get AI-generated responses.
|
|
160
|
+
|
|
161
|
+
Args:
|
|
162
|
+
prompt (str): The search query or prompt to send to the API.
|
|
163
|
+
stream (bool, optional): If True, yields response chunks as they arrive.
|
|
164
|
+
If False, returns complete response. Defaults to False.
|
|
165
|
+
raw (bool, optional): If True, returns raw response dictionaries with 'text' key.
|
|
166
|
+
If False, returns Response objects that convert to text automatically.
|
|
167
|
+
Defaults to False.
|
|
168
|
+
|
|
169
|
+
Returns:
|
|
170
|
+
Union[Response, Generator[Union[Dict[str, str], Response], None, None]]:
|
|
171
|
+
- If stream=False: Returns complete response
|
|
172
|
+
- If stream=True: Yields response chunks as they arrive
|
|
173
|
+
|
|
174
|
+
Raises:
|
|
175
|
+
APIConnectionError: If the API request fails
|
|
176
|
+
"""
|
|
177
|
+
payload = {
|
|
178
|
+
"spaceId": self.space_id,
|
|
179
|
+
"threadId": self.thread_id,
|
|
180
|
+
"userMessageId": self.user_message_id,
|
|
181
|
+
"userId": self.user_id,
|
|
182
|
+
"query": prompt,
|
|
183
|
+
"agentId": "liner",
|
|
184
|
+
"platform": "web",
|
|
185
|
+
"regenerate": False,
|
|
186
|
+
"showReferenceChunks": True,
|
|
187
|
+
"mode": "general",
|
|
188
|
+
"answerMode": "search",
|
|
189
|
+
"isReasoningMode": self.reasoning_mode,
|
|
190
|
+
"experimentId": random.randint(80, 90),
|
|
191
|
+
"modelType": "liner",
|
|
192
|
+
"experimentVariants": [],
|
|
193
|
+
"isDeepResearchMode": self.deep_search
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
def for_stream():
|
|
197
|
+
try:
|
|
198
|
+
with self.session.post(
|
|
199
|
+
self.chat_endpoint,
|
|
200
|
+
json=payload,
|
|
201
|
+
stream=True,
|
|
202
|
+
timeout=self.timeout,
|
|
203
|
+
) as response:
|
|
204
|
+
if not response.ok:
|
|
205
|
+
raise exceptions.APIConnectionError(
|
|
206
|
+
f"Failed to generate response - ({response.status_code}, {response.reason}) - {response.text}"
|
|
207
|
+
)
|
|
208
|
+
|
|
209
|
+
current_reasoning = ""
|
|
210
|
+
current_answer = ""
|
|
211
|
+
|
|
212
|
+
for line in response.iter_lines(decode_unicode=True):
|
|
213
|
+
if line == "event:finish_answer":
|
|
214
|
+
break
|
|
215
|
+
|
|
216
|
+
if line.startswith('data:'):
|
|
217
|
+
try:
|
|
218
|
+
data = json.loads(line[5:]) # Remove 'data:' prefix
|
|
219
|
+
|
|
220
|
+
# Handle reasoning updates if enabled
|
|
221
|
+
if self.reasoning_mode and 'reasoning' in data:
|
|
222
|
+
current_reasoning += data['reasoning']
|
|
223
|
+
if raw:
|
|
224
|
+
yield {"text": data['reasoning']}
|
|
225
|
+
else:
|
|
226
|
+
yield Response(data['reasoning'])
|
|
227
|
+
|
|
228
|
+
# Handle answer updates
|
|
229
|
+
if 'answer' in data:
|
|
230
|
+
current_answer += data['answer']
|
|
231
|
+
if raw:
|
|
232
|
+
yield {"text": data['answer']}
|
|
233
|
+
else:
|
|
234
|
+
yield Response(data['answer'])
|
|
235
|
+
|
|
236
|
+
except json.JSONDecodeError:
|
|
237
|
+
continue
|
|
238
|
+
|
|
239
|
+
except requests.exceptions.RequestException as e:
|
|
240
|
+
raise exceptions.APIConnectionError(f"Request failed: {e}")
|
|
241
|
+
|
|
242
|
+
def for_non_stream():
|
|
243
|
+
full_response = ""
|
|
244
|
+
for chunk in for_stream():
|
|
245
|
+
if raw:
|
|
246
|
+
yield chunk
|
|
247
|
+
else:
|
|
248
|
+
full_response += str(chunk)
|
|
249
|
+
|
|
250
|
+
if not raw:
|
|
251
|
+
self.last_response = Response(full_response)
|
|
252
|
+
return self.last_response
|
|
253
|
+
|
|
254
|
+
return for_stream() if stream else for_non_stream()
|
|
255
|
+
|
|
256
|
+
|
|
257
|
+
if __name__ == "__main__":
|
|
258
|
+
from rich import print
|
|
259
|
+
|
|
260
|
+
ai = Liner(cookies_path="cookies.json")
|
|
261
|
+
response = ai.search(input(">>> "), stream=True, raw=False)
|
|
262
|
+
for chunk in response:
|
|
263
263
|
print(chunk, end="", flush=True)
|