add search api implementation; update readme

readme.md

@@ -1 +1,19 @@
-Twitter GraphQL and Search API implementation with [SNScrape](https://github.com/JustAnotherArchivist/snscrape) data models.
+Twitter GraphQL and Search API implementation with [SNScrape](https://github.com/JustAnotherArchivist/snscrape) data models.
+
+### Usage
+
+```python
+import asyncio
+from twapi.client import UserClient
+from twapi.search import Search
+
+async def main():
+    account = UserClient("user", "pass", "user@example.com", "email_pass")
+    search = Search(account)
+
+    async for rep, data, _ in search.query("elon musk"):
+        print(rep.status_code, data)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```

twapi/search.py

@@ -0,0 +1,86 @@
+from httpx import AsyncClient
+from loguru import logger
+
+from .client import UserClient
+
+BASIC_SEARCH_PARAMS = """
+include_profile_interstitial_type=1
+include_blocking=1
+include_blocked_by=1
+include_followed_by=1
+include_want_retweets=1
+include_mute_edge=1
+include_can_dm=1
+include_can_media_tag=1
+include_ext_has_nft_avatar=1
+include_ext_is_blue_verified=1
+include_ext_verified_type=1
+include_ext_profile_image_shape=1
+skip_status=1
+cards_platform=Web-12
+include_cards=1
+include_ext_alt_text=true
+include_ext_limited_action_results=false
+include_quote_count=true
+include_reply_count=1
+tweet_mode=extended
+include_ext_views=true
+include_entities=true
+include_user_entities=true
+include_ext_media_color=true
+include_ext_media_availability=true
+include_ext_sensitive_media_warning=true
+include_ext_trusted_friends_metadata=true
+send_error_codes=true
+simple_quoted_tweet=true
+tweet_search_mode=live
+query_source=recent_search_click
+pc=1
+spelling_corrections=1
+include_ext_edit_control=true
+ext=mediaStats%2ChighlightedLabel%2ChasNftAvatar%2CvoiceInfo%2CbirdwatchPivot%2Cenrichments%2CsuperFollowMetadata%2CunmentionInfo%2CeditControl%2Cvibe
+"""
+
+SEARCH_URL = "https://api.twitter.com/2/search/adaptive.json"
+SEARCH_PARAMS = dict(x.split("=") for x in BASIC_SEARCH_PARAMS.splitlines() if x)
+
+
+class Search:
+    def __init__(self, account: UserClient):
+        self.account = account
+
+    def get_next_cursor(self, res: dict) -> str | None:
+        try:
+            for x in res["timeline"]["instructions"]:
+                entry = x.get("replaceEntry", None)
+                if entry is not None and entry["entryIdToReplace"] == "sq-cursor-bottom":
+                    return entry["entry"]["content"]["operation"]["cursor"]["value"]
+
+                for entry in x.get("addEntries", {}).get("entries", []):
+                    if entry["entryId"] == "sq-cursor-bottom":
+                        return entry["content"]["operation"]["cursor"]["value"]
+        except Exception as e:
+            logger.debug(e)
+            return None
+
+    async def query(self, q: str, cursor: str | None = None):
+        client = AsyncClient()
+        client.headers.update(self.account.client.headers)
+        client.cookies.update(self.account.client.cookies)
+
+        total_count = 0
+        while True:
+            params = {**SEARCH_PARAMS, "q": q, "count": 20}
+            params["cursor" if cursor else "requestContext"] = cursor if cursor else "launch"
+
+            rep = await client.get(SEARCH_URL, params=params)
+            rep.raise_for_status()
+
+            data = rep.json()
+            cursor = self.get_next_cursor(data)
+            tweets = data.get("globalObjects", {}).get("tweets", [])
+            if not tweets or not cursor:
+                return
+
+            total_count += len(tweets)
+            yield rep, data, cursor