{"id":20987243,"url":"https://github.com/haxpor/fkit","last_synced_at":"2026-04-16T09:02:52.481Z","repository":{"id":149552888,"uuid":"77205313","full_name":"haxpor/fkit","owner":"haxpor","description":"WeChat bot to help misc stuff for foreigners living in China","archived":false,"fork":false,"pushed_at":"2017-06-08T23:45:46.000Z","size":107,"stargazers_count":1,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-12-27T20:46:05.185Z","etag":null,"topics":["bot","fkit","foreignerkit","javascript","node","nodejs","wechat","wechat-bot"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/haxpor.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-12-23T06:59:22.000Z","updated_at":"2019-02-13T02:36:31.000Z","dependencies_parsed_at":null,"dependency_job_id":"9520fc4a-3caf-4028-b2cf-e770c0065274","html_url":"https://github.com/haxpor/fkit","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/haxpor/fkit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haxpor%2Ffkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haxpor%2Ffkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haxpor%2Ffkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haxpor%2Ffkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/haxpor","download_url":"https://codeload.github.com/haxpor/fkit/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haxpor%2Ffkit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31878832,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-16T07:36:03.521Z","status":"ssl_error","status_checked_at":"2026-04-16T07:35:53.576Z","response_time":69,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","fkit","foreignerkit","javascript","node","nodejs","wechat","wechat-bot"],"created_at":"2024-11-19T06:16:23.715Z","updated_at":"2026-04-16T09:02:52.464Z","avatar_url":"https://github.com/haxpor.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# fkit\n\nBased on basic code of WeChat bot of ReignDesign's [Building a WeChat (Weixin) robot](http://blog.reigndesign.com/blog/building-a-wechat-weixin-robot/).  \n*fkit* or foreigner-kit is a wechat bot to help misc stuff for foreigners living in China. \n\n# Set Up\n\n## Verification Request from WeChat\n\nTo make verification system works, you need to get token from dashboard and set it as environment variable on server that runs the bot. Do this to avoid hard-coding token into source code.\n\n* Login to [WeChat Admin Page](https://mp.weixin.qq.com) then note `Token`.\n* On server (production environment), or local system (development environment), execute `export FKIT_TOKEN=xxxx` in which `xxxx` is token you got from previous step.\n* To make it effective every time, and every login session, add `export FKIT_TOKEN=xxxx` inside `~/.bash_profile` too.\n\n## Set up Bot's URL\n\nInternally bot will send full URL for users to access resource which required it to know beforehand.\nSet this via environment variable again as follows.\n\n* On server (production environment), or local system (development environment), execute `export FKIT_URL=xxxx` in which `xxxx` is something like `https://yourapi.domain.com/bot` (without slash `/` at the end). \n* To make it effective every time, and every login session. We do the same as in case of token in previous section. Add `export FKIT_URL=xxxx` inside `~/.bash_profile` too.\n\n## Environment Variables\n\nIn summary, Fkit uses the following environment variables to make it operational\n\n* `FKIT_TOKEN=xxxx` which is token you get from WeChat Admin Page's Token section\n* `FKIT_URL=xxxx` which is url webhook setup i.e. `https://yourapi.domain.com/bot`\n* `FKIT_APPID=xxxx` which is Baidu's fanyi (translation service) app id\n* `FKIT_KEY=xxxx` which is Baidu's fanyi (translation service) key\n\nMake sure you have this set up and they are known by your system before running the application.\n\n# Start the Bot\n\nFollow the following step to start the bot\n* See section *Verfification Request from Wechat* to set up token to use with the bot\n* Go to FKit's root directory via command line, then go to `./scripts` directory.\n* Execute `start.sh` script via `./start.sh`. If there's any existing FKit (node) process running, it will kill it first.\n* Interact with the bot via WeChat.\n\n# Follow The Bot\n\nScan the following QR Code image to follow, and interact with the bot.  \nIf you're looking this page from within WeChat, then just hold down on the image until there's a context menu shows up that includes \"Extract QR code\", then select that option.\n\n![fkit qr code](qrcode-fkit-wechat-bot.jpg)\n\n# License\n\n[![Creative Commons License](https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png)](http://creativecommons.org/licenses/by-nc-sa/4.0/)  \nThis work is licensed under a [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License](https://github.com/haxpor/fkit/blob/master/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhaxpor%2Ffkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhaxpor%2Ffkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhaxpor%2Ffkit/lists"}