ima-wechat-batch-uploader

Batch upload WeChat official account articles from CSV to IMA knowledge base folders.

1|Updated Jul 13, 2026
One-click install
npx skills add https://github.com/HalseyYang/Skills-HY --skill ima-wechat-batch-uploader-halseyyang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ima-wechat-batch-uploader
Source: https://github.com/HalseyYang/Skills-HY/tree/main/ima-wechat-batch-uploader
Command: npx skills add https://github.com/HalseyYang/Skills-HY --skill ima-wechat-batch-uploader-halseyyang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Importing dozens or hundreds of WeChat official account articles into an IMA knowledge base one by one is tedious and error-prone. This Skill automates filtering, batching, and uploading article URLs from a CSV file into a specific IMA knowledge base folder. ## Core Features & Use Cases - CSV Filtering: Excludes non-regulatory articles (recruitment, events, holiday posts) by keyword matching and deduplicates by title, producing kept and excluded lists for review. - Batch Upload via IMA OpenAPI: Imports URLs in batches of up to 10 with 2-second intervals, automatically fixing & HTML entities in URLs so article titles resolve correctly. - Result Verification: Queries the target folder after upload to confirm article counts and detect entries whose titles still show as raw URLs. - Use Case: You have a CSV export of 200 WeChat articles from a regulatory affairs account. Filter out event announcements, confirm the list, then upload the remaining 150 articles into your IMA regulatory knowledge base folder in one run. ## Quick Start Filter the articles in my CSV file and upload the regulatory ones to my IMA knowledge base folder.

Frequently Asked Questions about ima-wechat-batch-uploader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I batch upload WeChat articles to IMA knowledge base?

Prepare a CSV with title and url columns, run the filter script to exclude unwanted articles, then run the batch upload script with your knowledge base ID and folder ID. URLs are imported in batches of up to 10 via the IMA OpenAPI import_urls endpoint.

How to filter WeChat articles from a CSV by keyword?

Run filter_csv.js with your CSV path and optionally a custom keywords file. It excludes titles containing keywords like recruitment or event terms, deduplicates by title, and outputs filtered_articles.json, excluded_articles.json, and a preview text file.

Why do uploaded IMA articles show the URL as the title?

This happens when the URL contains HTML-encoded & entities instead of raw & characters, so the IMA server cannot parse the WeChat article. The upload script fixes this by replacing & with & before importing.

What credentials does the IMA OpenAPI import require?

You need the IMA OpenAPI Client ID and API Key, set as IMA_OPENAPI_CLIENTID and IMA_OPENAPI_APIKEY environment variables or stored in ~/.config/ima/ files. Credentials from ima-mcp will not work and cause a skill auth failed error.

What is the difference between IMA knowledge base id and kb_id?

The id returned by search_knowledge_base is a display ID that the API rejects. You must call get_knowledge_base to retrieve the Base64-format kb_id, which is the valid identifier for import_urls and get_knowledge_list calls.

What are the limits of the IMA import_urls API?

The import_urls endpoint accepts a maximum of 10 URLs per request, so larger imports must be split into batches. The script enforces this limit and waits 2 seconds between batches to avoid rate limiting.