# iQiyi Open Platform MCP MCP > iQiyi Open Platform / 爱奇艺开放平台 lets your agent access China's leading video streaming data. You can verify user VIP status, audit complex order histories, and search deep content metadata for movies and shows. It retrieves basic user profiles and provides popular video rankings instantly. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** video-streaming, user-profile, membership-management, content-discovery, media-data, vip-status ## Description This MCP connects your AI client directly to iQiyi's operational backend, giving you visibility into membership and content data without needing to log into any developer portal. You can run market research or audit customer accounts by asking natural language questions about users and titles. Your agent retrieves user identifiers, checks if a VIP subscription is active and when it expires, and searches the entire library for specific movies or shows. If you're building out an internal data pipeline, Vinkius makes connecting this iQiyi Open Platform MCP simple, allowing your agent to handle everything from listing all available content categories to retrieving detailed order records in one go. It’s essentially a real-time entertainment coordinator built right into your workflow. ## Tools ### get_content_metadata Retrieves detailed information about a specific movie or show title. ### get_order_info Pulls the full details for a single user order or membership package. ### get_user_profile Gets essential information like the nickname and unique ID for a specific user account. ### get_video_rankings Returns lists of popular content based on criteria like 'hot' or 'new'. ### get_vip_status Checks the current VIP membership level and whether the account is active. ### list_user_orders Retrieves a list summarizing all previous orders made by a user. ### list_video_categories Shows all the content types available on iQiyi (e.g., drama, documentary). ### search_video_content Searches the entire video library for titles matching a specific keyword or phrase. ## Prompt Examples **Prompt:** ``` Search for 'The Wandering Earth' in the iQiyi library. ``` **Response:** ``` I've searched the iQiyi library for you. I found 'The Wandering Earth' (2019) and several related titles. Would you like me to retrieve the detailed metadata or the latest popularity ranking for this movie? ``` **Prompt:** ``` Check the VIP membership status for token 'SESSION_8821'. ``` **Response:** ``` I've retrieved the VIP status for the user. They are currently a 'Gold VIP' (Level 5) with an active subscription valid until 2024-12-31. Should I also check their recent order history? ``` **Prompt:** ``` List all available iQiyi membership packages. ``` **Response:** ``` I've retrieved the membership package list. You have several options including 'Standard Monthly VIP' (25 CNY), 'Quarterly Gold' (68 CNY), and 'Annual Diamond' (248 CNY). Would you like to see the specific benefits for each level? ``` ## Capabilities ### Search for video titles The system searches the iQiyi library and returns metadata, showing if movies or shows match specific keywords. ### Check user membership status It verifies a user’s VIP level and tells you exactly when their current subscription expires. ### Audit historical orders The agent lists all past purchases for a given user, retrieving detailed metadata about the membership packages purchased. ### Retrieve basic user data You can pull core profile information, like the user's unique ID and display nickname. ### Find popular content trends It pulls real-time popularity rankings for movies and shows across different categories (hot, new, etc.). ## Use Cases ### Investigating subscription gaps A customer complains they lost access to premium features. You ask the agent to run `get_vip_status` on their account, which immediately confirms they are 'Gold VIP' but that the subscription expired last week. Then you use `list_user_orders` to show them when they can re-subscribe. ### Competitive content tracking You need a report on what types of shows are performing well right now. You first call `get_video_rankings`, then use `list_video_categories` to filter the results, and finally run `search_video_content` to pull metadata for the top 5 titles. ### Onboarding a new client A sales team needs to confirm if a potential high-value user has existing membership packages. The agent uses `get_user_profile` first, then immediately calls `list_user_orders` to provide the full purchase history for review. ### Debugging content access issues A developer needs to check if a piece of media is available. They run `search_video_content`, and when they find the title, they use `get_content_metadata` to confirm its genre, runtime, and availability. ## Benefits - Quickly verify user subscription health. Instead of clicking through multiple billing pages, your agent uses `get_vip_status` to immediately tell you if a user's membership is active or when it expires. - Automate market research. You can ask the agent to find popular rankings using `get_video_rankings`, giving you immediate data on what content titles are trending across different categories. - Centralize customer history. Use `list_user_orders` and `get_order_info` to pull a complete, auditable record of a user's spending or package purchases in one request. - Improve content discovery. Need to know if 'The Wandering Earth' is available? `search_video_content` finds the title, and `get_content_metadata` gives you all the details on it. - Streamline profile management. Get basic user info fast using `get_user_profile`, eliminating manual lookups of a client's nickname or unique ID. ## How It Works The bottom line is you get structured iQiyi video and user data directly from your AI client's conversational output. 1. Subscribe to this MCP and input your required iQiyi AppKey and MD5 Key. 2. Your agent uses the credentials to initiate a data request for profiles, orders, or content metadata. 3. The system returns structured JSON containing all requested details, like VIP status or title information. ## Frequently Asked Questions **How do I check a user's VIP membership status using get_vip_status?** You pass the required user identifier to `get_vip_status`. The system returns their current level (e.g., Gold VIP) and the exact date when that subscription is set to expire. **Can I use search_video_content to find a genre?** No, `search_video_content` searches by title or keyword. To filter by content type, you should first call `list_video_categories` and then refine your search query. **What information does get_user_profile give me?** It retrieves the core metadata for a user, specifically their unique ID and display nickname. This is often needed as an input for other tools like `get_vip_status`. **Does list_user_orders show current memberships?** No. `list_user_orders` shows historical records of what the user has purchased. For current status, always use `get_vip_status`. **How do I authenticate my connection when calling a tool like `get_user_profile`?** You must provide your iQiyi AppKey and MD5 Key during setup. These credentials authorize all calls to this MCP. The service uses these keys to validate every request, ensuring you only access data for which you have permission. **What should I do if the `get_video_rankings` call fails due to rate limits?** If the rankings tool hits a limit, wait about 60 seconds and try again. The API handles temporary spikes by throttling requests. We recommend implementing a short delay between multiple calls to prevent continuous failure. **Does `get_content_metadata` provide enough detail for marketing reports?** Yes, the metadata tool retrieves deep details about the content itself, including genre codes and production years. This allows you to build comprehensive reports without needing separate sources for basic video information. **How can I list all possible content types before searching using `list_video_categories`?** The `list_video_categories` tool fetches the full hierarchy of available genres and groupings. You run this first to see all options, which then helps you refine your subsequent searches with `search_video_content`.