Open a visible browser so you can sign in to Instagram by hand.

Credentials are never stored — only the browser profile is persisted, so you log in once. Use force=True to re-auth an expired session or clear a checkpoint. WARNING: automating Instagram violates its ToS and risks the account. Use a secondary/throwaway account, never your main.

Report whether the persisted Instagram session is currently logged in.

Clear the persisted browser profile. Next run requires login() again.

Diagnose setup: browser availability, profile path, auth state, next action.

Scroll the default Instagram Reels feed and return structured reel metadata.

Returns {reels: [...], count, timing, fill_rate}. Each reel: url, creator, caption, description (= caption), visual_description (IG auto alt-text), likes, comments, views, shares, reposts, date_posted (ISO 8601), date_posted_ts (unix), audio, _source. Engagement fields are best-effort — missing ones come back null rather than failing.

Note on views: the home feed omits view/play counts, so views is null here. Use search_reels/hashtag_reels for reels WITH view counts. See docs/views-investigation.md. shares and reposts are the same metric.

mode (optional): one of fast_test, normal_passive, conservative. Controls humanized delay/cap. Defaults to the server's configured mode.

This call drives the default feed only. For a topic use search_reels; for a tag use hashtag_reels.

Search Instagram by keyword and return matching reels.

Same reel shape and error handling as scroll_reels, sourced from the explore search results for query (e.g. "beginner yoga"). Unlike the feed, search results DO include views (play counts). comments is not in this payload (comes back null).

Browse a hashtag page and return its reels.

tag with or without a leading '#'. Same reel shape and errors as scroll_reels, sourced from instagram.com/explore/tags//.