kuaishou-account-search

Kuaishou Account Search (Broad-Domain Database)

📝 Introduction

Fuzzy contains-match search for accounts by Kuaishou account name (profile.userName), quickly locating the target account and obtaining the kwaiId, which is used for subsequently querying the account's work list.

✨ Features

Feature Module	Capability Description	Core Value
Fuzzy Name Search	Search by entering an account name keyword (e.g., "People's Daily")	No precise ID needed; locate by entering the name
Return kwaiId	Each account returns the platform-displayed id (kwaiId)	Use directly with queryWorkList to query works
Account Profile	Nickname, avatar, cover, and bio at a glance	Quickly determine the account's positioning and content direction
Paginated Browsing	Up to 50 items per page, supports browsing multiple pages	No same-name/similar accounts missed

🎯 Target Users

🔍 Content Creators — Search accounts in the same niche and break down benchmark accounts.
📊 Operations / Data Analysis — Quickly locate target accounts and obtain their kwaiId.
🏢 Brands / MCNs — Screen potential partner influencer accounts.

🔑 Authentication

Get API Key

Visit the Honghu Hub official website to learn about service details
Go to the registration page to register an account
Newly registered users will receive free credits, and can immediately start using the API service
After registering and logging in, obtain the API Key in the personal center, in the format ak_xxxxxxxx

Configure API Key

REDFOX_API_KEY Obtained from environment variables, format ak_xxxxxxxx
If not set, prompt the user to configure it themselves:export REDFOX_API_KEY=<你的apikey>; if the user does not know how to configure it, the Agent should proactively help the user set it up:
- macOS/Linux: Append export REDFOX_API_KEY=<值> to ~/.zshrc(zsh) or ~/.bashrc(bash), then source the corresponding file to make it take effect globally
- Windows: Use [Environment]::SetEnvironmentVariable("REDFOX_API_KEY", "<值>", "User") to set a user-level permanent environment variable (requires restarting the terminal to take effect)
- After configuration is complete, verify:echo $REDFOX_API_KEY(macOS/Linux) or echo %REDFOX_API_KEY%(Windows), to ensure it can be read even when switching to another skill

🔄 Usage Guide

Locate the target account through fuzzy search by Kuaishou account name, and after obtaining kwaiId , it can be used directly to query the account's work list.

For detailed execution steps, parameter descriptions, and output format, see references/core_workflow.md

⏰ Data Freshness

Data is updated every morning at 06:00 (broad-domain database snapshot).

📂 Related Files

Path	Purpose
`scripts/search_ks_user.py`	Account search script (searchUser interface)
`references/core_workflow.md`	Core execution flow and output specification
`README.md`	Complete interface description and return field documentation