Placed Resume Builder
Build and manage professional resumes via the Placed API. No MCP server required — all calls are made directly with curl.
API Key
Load the key from ~/.config/placed/credentials, falling back to the environment:
CODEBLOCK0
If PLACED_API_KEY is still not set, ask the user:
"Please provide your Placed API key (get it at https://placed.exidian.tech/settings/api)"
Then save it for future sessions:
CODEBLOCK1
How to Call the API
CODEBLOCK2
Available Tools
| Tool | Description |
|---|
| INLINECODE2 | List all resumes |
| INLINECODE3 |
Create a new resume |
|
get_resume | Get resume by ID (or most recent if no ID) |
|
update_resume | Update any resume section |
|
get_resume_schema | See all available fields and formats |
|
list_resume_templates | Browse available templates |
|
get_template_preview | Preview a specific template |
|
change_resume_template | Switch resume template |
|
get_resume_pdf_url | Get PDF download URL (expires 15 min) |
|
get_resume_docx_url | Get Word document download URL |
|
export_resume_json | Export resume as JSON |
|
export_resume_markdown | Export resume as Markdown |
Usage Examples
List all resumes:
CODEBLOCK3
Create a resume:
CODEBLOCK4
Update resume sections:
CODEBLOCK5
Get PDF download URL:
CODEBLOCK6
Change template:
CODEBLOCK7
Export as Markdown:
CODEBLOCK8
Resume Sections
All sections are optional and can be updated independently via update_resume:
- -
basics — name, email, phone, headline, location - INLINECODE16 — professional overview
- INLINECODE17 — work history with company, position, date, bullets
- INLINECODE18 — degrees, institutions, dates
- INLINECODE19 — skill groups with keywords
- INLINECODE20 — language proficiencies
- INLINECODE21 — professional certs with issuer and date
- INLINECODE22 — honors and recognition
- INLINECODE23 — personal/professional projects
- INLINECODE24 — articles, papers, books
- INLINECODE25 — professional references
- INLINECODE26 — volunteer experience
- INLINECODE27 — hobbies and interests
- INLINECODE28 — LinkedIn, GitHub, portfolio links
Tips
- - Call
get_resume_schema to see exact field formats before updating - Quantify achievements with metrics (numbers, percentages, dollars)
- Use action verbs at the start of bullet points
- Mirror job description language for better ATS matching
- Use
placed-resume-optimizer skill to check ATS compatibility after building
Placed 简历生成器
通过 Placed API 构建和管理专业简历。无需 MCP 服务器——所有调用均直接使用 curl 完成。
API 密钥
从 ~/.config/placed/credentials 加载密钥,若未找到则回退到环境变量:
bash
if [ -z $PLACEDAPIKEY ] && [ -f $HOME/.config/placed/credentials ]; then
source $HOME/.config/placed/credentials
fi
如果 PLACEDAPIKEY 仍未设置,请询问用户:
请提供您的 Placed API 密钥(获取地址:https://placed.exidian.tech/settings/api)
然后保存以供后续会话使用:
bash
mkdir -p $HOME/.config/placed
echo export PLACEDAPIKEY=<用户提供的密钥> > $HOME/.config/placed/credentials
export PLACEDAPIKEY=<用户提供的密钥>
如何调用 API
bash
placed_call() {
local tool=$1
local args=${2:-{}}
curl -s -X POST https://placed.exidian.tech/api/mcp \
-H Authorization: Bearer $PLACEDAPIKEY \
-H Content-Type: application/json \
-d {\jsonrpc\:\2.0\,\id\:1,\method\:\tools/call\,\params\:{\name\:\$tool\,\arguments\:$args}} \
| python3 -c import sys,json; d=json.load(sys.stdin); print(d[result][content][0][text])
}
可用工具
| 工具名称 | 描述 |
|---|
| listresumes | 列出所有简历 |
| createresume |
创建新简历 |
| get_resume | 按 ID 获取简历(无 ID 则获取最近一份) |
| update_resume | 更新任意简历部分 |
| get
resumeschema | 查看所有可用字段和格式 |
| list
resumetemplates | 浏览可用模板 |
| get
templatepreview | 预览特定模板 |
| change
resumetemplate | 切换简历模板 |
| get
resumepdf_url | 获取 PDF 下载链接(15 分钟有效) |
| get
resumedocx_url | 获取 Word 文档下载链接 |
| export
resumejson | 以 JSON 格式导出简历 |
| export
resumemarkdown | 以 Markdown 格式导出简历 |
使用示例
列出所有简历:
bash
placedcall listresumes
创建简历:
bash
placedcall createresume {title:高级工程师简历,target_role:首席工程师}
更新简历部分:
bash
placedcall updateresume {
resumeid: resabc123,
summary: 拥有10年以上经验的首席SRE...,
skills: [{name:基础设施,keywords:[Kubernetes,Terraform,AWS]}]
}
获取 PDF 下载链接:
bash
placedcall getresumepdfurl {resumeid:resabc123}
切换模板:
bash
首先列出模板
placed
call listresume_templates
然后应用一个模板
placed
call changeresume
template {resumeid:res
abc123,templateid:onyx}
导出为 Markdown:
bash
placedcall exportresumemarkdown {resumeid:res_abc123}
简历组成部分
所有部分均为可选,可通过 update_resume 独立更新:
- - basics — 姓名、邮箱、电话、标题、所在地
- summary — 职业概述
- experience — 工作经历(公司、职位、日期、要点)
- education — 学历、院校、日期
- skills — 技能组及关键词
- languages — 语言能力
- certifications — 专业认证(颁发机构及日期)
- awards — 荣誉与表彰
- projects — 个人/专业项目
- publications — 文章、论文、书籍
- references — 专业推荐人
- volunteer — 志愿者经历
- interests — 兴趣爱好
- profiles — LinkedIn、GitHub、作品集链接
提示
- - 更新前调用 getresumeschema 查看精确字段格式
- 用量化指标(数字、百分比、金额)衡量成就
- 要点开头使用动作动词
- 镜像职位描述语言以获得更好的 ATS 匹配
- 构建完成后使用 placed-resume-optimizer 技能检查 ATS 兼容性