donation-place-search

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

기부처 조회 / Donation Place Search

捐赠机构查询 / Donation Place Search

What this skill does

此技能的功能

사용자가 “어디에 기부하면 좋을지”, “서울 아동 기부처”, “동물보호 기부처 추천”처럼 묻는 경우 장소와 카테고리 기준으로 기부처 후보를 추천한다.
  • 기부를 대신 실행하지 않는다.
  • 결제, 개인정보 입력, 자동 후원 신청은 하지 않는다.
  • 추천은 의사결정 보조이며, 최종 기부 전 공식 페이지와 1365 기부포털에서 최신 등록·모금기간·기부금영수증 가능 여부를 확인한다.
  • 위치는 사용자가 제공한 행정구역/동네/랜드마크 텍스트만 사용한다. 자동 위치 추적을 하지 않는다.
当用户询问“哪里适合捐赠”、“首尔儿童捐赠机构”、“推荐动物保护捐赠机构”这类问题时,将根据地点和类别推荐捐赠机构候选
  • 不代为执行捐赠操作。
  • 不进行支付、个人信息输入、自动捐赠申请等操作。
  • 推荐仅作为决策辅助,最终捐赠前请在官方页面和1365捐赠门户确认最新注册信息、募捐期限及是否可开具捐赠收据。
  • 仅使用用户提供的行政区/社区/地标文本确定位置,不进行自动位置追踪。

When to use

使用场景

  • “기부처 조회해줘”
  • “서울 마포구에서 동물보호 기부할 만한 곳 추천해줘”
  • “부산 노인 복지 기부처 알려줘”
  • “아동/재난 분야 기부처 비교해줘”
  • “어디에 기부하는 곳이 좋을지 장소와 카테고리별로 추천해줘”
  • “帮我查询捐赠机构”
  • “推荐首尔麻浦区可以进行动物保护捐赠的地方”
  • “告诉我釜山的老年福利捐赠机构”
  • “对比儿童/灾难领域的捐赠机构”
  • “按地点和类别推荐适合捐赠的地方”

Inputs

输入参数

  • location
    : 선택. 예:
    서울 마포구
    ,
    부산 해운대구
    ,
    제주
    ,
    온라인
  • category
    : 선택. 예:
    아동
    ,
    동물보호
    ,
    환경
    ,
    재난 구호
    ,
    장애
    ,
    노인
    ,
    생계
    ,
    의료
    ,
    해외구호
  • limit
    : 선택. 기본 5개
위치나 카테고리가 없으면 보수적으로
전국
·
일반/종합
후보와 1365 공식 확인 보조 링크를 제공한다. 비대화형 자동화에서는 임의로 좁히지 말고 “입력 없음”을 명시한다.
  • location
    :可选。示例:
    서울 마포구
    (首尔麻浦区)、
    부산 해운대구
    (釜山海云台区)、
    제주
    (济州)、
    온라인
    (线上)
  • category
    :可选。示例:
    아동
    (儿童)、
    동물보호
    (动物保护)、
    환경
    (环境)、
    재난 구호
    (灾难救援)、
    장애
    (残障)、
    노인
    (老年)、
    생계
    (生计)、
    의료
    (医疗)、
    해외구호
    (海外救援)
  • limit
    :可选。默认返回5个候选
若未提供位置或类别,则保守地提供
全国
·
综合/通用
候选及1365官方确认辅助链接。在非交互式自动化场景中,请勿随意缩小范围,需明确标注“无输入”。

Public access path discovered

已发现的公开访问路径

Primary official verification surface

主要官方验证入口

  • Legacy
    https://www.nanumkorea.go.kr/
    currently returns a notice that 1365 기부포털 has moved/integrated into 1365 자원봉사.
  • The notice links to
    https://www.1365.go.kr/dntn/main.do
    .
  • The skill therefore uses
    https://www.1365.go.kr/dntn/main.do
    as the official public verification entry point.
  • 旧版地址
    https://www.nanumkorea.go.kr/
    当前显示通知,提示1365 기부포털(捐赠门户)已迁移/整合至1365 자원봉사(志愿服务平台)。
  • 通知链接指向
    https://www.1365.go.kr/dntn/main.do
  • 因此本技能将
    https://www.1365.go.kr/dntn/main.do
    作为官方公开验证入口。

Search-link strategy

搜索链接策略

1365 pages can be slow or unavailable to headless HTTP clients, so the package does not depend on brittle screen scraping. It builds a best-effort official-entry/search-assist link with the user’s location/category keywords, then ranks a curated fallback list locally. The package does not assert that 1365 has already verified each returned candidate:
js
const { recommendDonationPlaces } = require("donation-place-search");

const result = recommendDonationPlaces({
  location: "서울 마포구",
  category: "동물",
  limit: 3
});

console.log(result.items);
console.log(result.officialSearchUrl);
The returned
officialSearchUrl
is a best-effort verification assist: open it as an official 1365 entry point, then confirm current registration and campaign status before giving the final answer.
1365页面在无头HTTP客户端中可能加载缓慢或无法访问,因此本工具不依赖脆弱的网页抓取。它会结合用户提供的位置/类别关键词构建尽可能准确的官方入口/搜索辅助链接,然后在本地对精心整理的备选列表进行排序。本工具不保证返回的每个候选都已通过1365验证:
js
const { recommendDonationPlaces } = require("donation-place-search");

const result = recommendDonationPlaces({
  location: "서울 마포구",
  category: "동물",
  limit: 3
});

console.log(result.items);
console.log(result.officialSearchUrl);
返回的
officialSearchUrl
是尽可能准确的验证辅助链接:将其作为1365官方入口打开,然后在给出最终答案前确认当前注册状态和活动情况。

Workflow

工作流程

  1. Extract
    location
    ,
    category
    , and optional
    limit
    from the user request.
  2. Run the helper:
bash
node - <<'NODE'
const {
  recommendDonationPlaces,
  formatDonationRecommendationReport
} = require("donation-place-search");

const result = recommendDonationPlaces({
  location: "서울 마포구",
  category: "동물",
  limit: 3
});

console.log(formatDonationRecommendationReport(result));
NODE
  1. Open or cite the returned best-effort 1365 verification-assist URL for latest verification when fresh browsing is available.
  2. Summarize 3–5 candidates, including:
    • 기부처명
    • 분야/카테고리
    • 지역 일치 여부 또는 전국 단위 여부
    • 왜 맞는지 한 줄
    • 공식 홈페이지
    • 1365 확인 보조 링크
  3. Add a caution that campaign status, donation receipt eligibility, and designated-use options must be checked on official pages before donating.
  1. 从用户请求中提取
    location
    category
    及可选的
    limit
    参数。
  2. 运行辅助工具:
bash
node - <<'NODE'
const {
  recommendDonationPlaces,
  formatDonationRecommendationReport
} = require("donation-place-search");

const result = recommendDonationPlaces({
  location: "서울 마포구",
  category: "동물",
  limit: 3
});

console.log(formatDonationRecommendationReport(result));
NODE
  1. 若可进行实时浏览,打开或引用返回的1365验证辅助链接以获取最新验证信息。
  2. 总结3-5个候选机构,包含以下信息:
    • 捐赠机构名称
    • 领域/类别
    • 是否匹配地区或是否为全国性机构
    • 推荐理由(一句话)
    • 官方主页
    • 1365验证辅助链接
  3. 添加提示:捐赠前必须在官方页面确认活动状态、捐赠收据资格及定向捐赠选项。

Output fields

输出字段

The npm helper returns:
json
{
  "location": { "raw": "서울 마포구", "province": "서울", "district": "마포구" },
  "category": "animals",
  "items": [
    {
      "name": "동물권행동 카라",
      "categories": ["animals"],
      "coverage": "local",
      "homepageUrl": "https://www.ekara.org/",
      "officialSearchUrl": "https://www.1365.go.kr/dntn/main.do?...",
      "match": { "category": true, "local": true, "nationwide": false }
    }
  ],
  "officialSearchUrl": "https://www.1365.go.kr/dntn/main.do?...",
  "meta": { "source": "curated-fallback-plus-1365-search-assist" }
}
npm辅助工具返回的内容如下:
json
{
  "location": { "raw": "서울 마포구", "province": "서울", "district": "마포구" },
  "category": "animals",
  "items": [
    {
      "name": "동물권행동 카라",
      "categories": ["animals"],
      "coverage": "local",
      "homepageUrl": "https://www.ekara.org/",
      "officialSearchUrl": "https://www.1365.go.kr/dntn/main.do?...",
      "match": { "category": true, "local": true, "nationwide": false }
    }
  ],
  "officialSearchUrl": "https://www.1365.go.kr/dntn/main.do?...",
  "meta": { "source": "curated-fallback-plus-1365-search-assist" }
}

Done when

完成标准

  • 장소/카테고리 조건을 반영해 후보를 3–5개 이내로 정리했다.
  • 각 후보마다 공식 홈페이지 또는 1365 확인 보조 링크를 제공했다.
  • 최종 기부 전 등록 상태, 모금 기간, 기부금영수증 가능 여부를 확인하라고 안내했다.
  • 자동 결제/후원 신청을 시도하지 않았다.
  • 根据地点/类别条件整理出3-5个候选机构。
  • 为每个候选机构提供官方主页或1365验证辅助链接。
  • 提示用户在最终捐赠前确认注册状态、募捐期限及是否可开具捐赠收据。
  • 未尝试自动支付/捐赠申请。

Failure modes

故障场景

  • 1365 사이트가 느리거나 headless HTTP에서 timeout/empty page를 반환할 수 있다. 이 경우 확인 보조 URL과 후보 홈페이지를 제공하고 “최신 상태는 직접 확인 필요”라고 명시한다.
  • 위치 문자열이 행정구역으로 파싱되지 않으면 전국 후보 위주로 제안한다.
  • 지역·카테고리 모두 정확히 맞는 후보가 없으면 전국 단위 후보를 fallback으로 보여준다.
  • 특정 단체의 모금 캠페인, 지정기부 가능 여부, 기부금영수증 처리는 수시로 바뀌므로 package 내 curated 설명만으로 확정하지 않는다.
  • 로그인, 결제, CAPTCHA, 후원 신청서 제출은 자동화하지 않는다.
  • 1365网站可能加载缓慢,或在无头HTTP环境中返回超时/空白页面。这种情况下,需提供验证辅助链接和候选机构主页,并明确标注“需自行确认最新状态”。
  • 若位置字符串无法解析为行政区,则优先推荐全国性候选机构。
  • 若没有完全匹配地区和类别的候选机构,则以全国性候选机构作为备选。
  • 特定机构的募捐活动、定向捐赠资格、捐赠收据处理方式可能随时变化,因此请勿仅凭工具内整理的描述做出确定结论。
  • 不自动化处理登录、支付、CAPTCHA、捐赠申请表提交等操作。

Notes

注意事项

  • 이 스킬은 read-only 추천/조회 스킬이다.
  • 기부는 금전 의사결정이므로 최신 공식 근거를 우선한다.
  • 공개 표면만 사용하므로
    k-skill-proxy
    와 API key가 필요 없다.
  • 此技能为只读型推荐/查询技能。
  • 捐赠涉及金钱决策,因此优先参考最新官方依据。
  • 仅使用公开入口,无需
    k-skill-proxy
    和API密钥。