wop-mcp 0.1.0__tar.gz

wop_mcp-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,23 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: uv sync
+      - name: Test with coverage gate (>=95%)
+        run: uv run pytest --cov=wop_mcp --cov-report=term-missing --cov-fail-under=95

wop_mcp-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,59 @@
+name: release
+
+on:
+  push:
+    tags: ['v*']
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    # PYPI_TOKEN 配置于 org 级 Actions secrets（visibility 覆盖本仓）；
+    # 不引用 environment，避免依赖环境自动创建策略
+    permissions:
+      # write 仅用于创建 GitHub Release 条目；PyPI 发布走 PYPI_TOKEN，不占 token 权限
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Verify tag matches pyproject version
+        # 版本单一源纪律：tag vX.Y.Z 必须与 pyproject [project].version 严格一致，
+        # 不一致即刻 fail（防止 tag 与发布产物版本漂移）
+        run: |
+          TAG_VERSION="${GITHUB_REF_NAME#v}"
+          PROJ_VERSION=$(python -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")
+          if [ "$TAG_VERSION" != "$PROJ_VERSION" ]; then
+            echo "::error::tag ${GITHUB_REF_NAME}（${TAG_VERSION}）与 pyproject.toml version（${PROJ_VERSION}）不一致"
+            exit 1
+          fi
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          # pytest/pytest-cov 属测试工具链而非运行时依赖，CI 显式安装
+          pip install -e . pytest pytest-cov
+      - name: Test with coverage gate (>= 95%, must pass before publish)
+        run: python -m pytest --cov=wop_mcp --cov-fail-under=95
+      - name: Build sdist and wheel
+        run: |
+          pip install build
+          python -m build
+      - name: Publish to PyPI
+        # 发布步骤位于测试全绿之后，失败不留半发布状态
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_TOKEN }}
+      - name: Create GitHub Release
+        # 仅在 PyPI 发布成功后执行（前置步骤失败即跳过）——Release 条目 = 已发布信号；
+        # 资产：创建即挂 dist/*（sdist+wheel，二进制归档语义）；已存在（workflow 重跑）时
+        # 补传 --clobber 幂等，不重复建条目；说明用 --generate-notes 基线，发布后可随时人工编辑
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          if gh release view "$GITHUB_REF_NAME" -R "$GITHUB_REPOSITORY" >/dev/null 2>&1; then
+            gh release upload "$GITHUB_REF_NAME" -R "$GITHUB_REPOSITORY" dist/* --clobber
+          else
+            gh release create "$GITHUB_REF_NAME" -R "$GITHUB_REPOSITORY" \
+              --title "wop-mcp ${VERSION}" --generate-notes dist/*
+          fi

wop_mcp-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.py[cod]
+.venv/
+dist/
+build/
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.coverage
+coverage.xml
+htmlcov/
+keys/
+certs/
+.DS_Store

wop_mcp-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

wop_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wop-platform
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

wop_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,153 @@
+Metadata-Version: 2.5
+Name: wop-mcp
+Version: 0.1.0
+Summary: 万联易达开放平台（WOP）MCP Server —— 文档获取与密钥对生成
+Project-URL: Homepage, https://github.com/wop-platform/wop-mcp
+Project-URL: Repository, https://github.com/wop-platform/wop-mcp
+Project-URL: Changelog, https://github.com/wop-platform/wop-mcp/releases
+Project-URL: Issues, https://github.com/wop-platform/wop-mcp/issues
+Author: wop-platform
+License: MIT
+License-File: LICENSE
+Keywords: mcp,open-platform,rsa,sm2,wanlianyida,wop
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Security :: Cryptography
+Requires-Python: >=3.10
+Requires-Dist: cryptography>=41
+Requires-Dist: gmssl>=3.2.2
+Requires-Dist: mcp>=2.0
+Requires-Dist: wop-python-sdk>=0.1.7
+Description-Content-Type: text/markdown
+
+# wop-mcp
+
+**万联易达开放平台（WOP）MCP Server —— 让 AI 助手安全、正确地完成 WOP 对接**
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![MCP](https://img.shields.io/badge/MCP-Server-orange.svg)](https://modelcontextprotocol.io/)
+[![Coverage ≥95%](https://img.shields.io/badge/coverage-%E2%89%A595%25-brightgreen)]()
+
+## 简介
+
+`wop-mcp` 是万联易达开放平台（WOP）的 [Model Context Protocol](https://modelcontextprotocol.io/) Server，
+帮助开发者通过 AI 助手（Claude Desktop、Cursor、Claude Code 等）完成 WOP 对接：
+
+- 📚 **文档获取**：接入指南、API 索引、接口详情（自动穿透文档 URL 的时间戳后缀）
+- 🔐 **密钥对生成**：RSA2048 / SM2，公钥按分发契约编码返回，可直接上报平台
+- 🛡️ **安全纪律**：私钥只写入本地 0600 文件，**永不回显进 AI 对话**（对齐 [wop-skills](https://github.com/wop-platform/wop-skills) SECURITY 纪律）
+- 🔌 **即插即用**：stdio transport，`uvx wop-mcp`（PyPI 发布后）一行接入
+
+## 工具总览
+
+| 工具 | 说明 |
+|---|---|
+| `wop_overview()` | 接入指南（三步流程、securityReq 组合、公钥编码、SDK 列表）+ 实时 `llms.txt` API 索引 |
+| `wop_api_detail(api)` | API 详情；入参支持 API 路径（如 `/staffing/open/v1/invoice/apply`，可带 POST 前缀、支持省略业务域前缀的后缀匹配）、接口中文名（如 `转账提交`）、完整 `.md` URL |
+| `wop_link_detail(url)` | 文档中心任意子页 / 外链内容（相对路径自动拼接基址，如 `llms-full.txt`） |
+| `wop_gen_key_pair(algorithm)` | `RSA2048`（别名 `RSA`）或 `SM2`；返回 `publicKey`（契约编码）+ `privateKeyFile`（0600 路径） |
+
+## 快速开始
+
+### 方式一：uvx 直接运行（PyPI 发布后）
+
+```bash
+uvx wop-mcp
+```
+
+### 方式二：源码运行
+
+```bash
+git clone https://github.com/wop-platform/wop-mcp.git
+cd wop-mcp
+uv sync
+uv run wop-mcp
+```
+
+## 在 AI 工具中配置
+
+### Cursor
+
+```json
+{
+  "mcpServers": {
+    "wop-mcp": {
+      "command": "uvx",
+      "args": ["wop-mcp"],
+      "timeout": 600,
+      "autoApprove": ["wop_overview", "wop_api_detail", "wop_link_detail"]
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+macOS：`~/Library/Application Support/Claude/claude_desktop_config.json`
+Windows：`%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "wop-mcp": {
+      "command": "uvx",
+      "args": ["wop-mcp"]
+    }
+  }
+}
+```
+
+源码方式将 `command`/`args` 替换为：
+
+```json
+{
+  "command": "uv",
+  "args": ["--directory", "/path/to/wop-mcp", "run", "wop-mcp"]
+}
+```
+
+> `wop_gen_key_pair` 写本地私钥文件，建议保留人工确认（未列入 autoApprove）。
+
+## 环境变量
+
+| 变量 | 默认值 | 说明 |
+|---|---|---|
+| `WOP_DOC_BASE_URL` | `https://assets.wanlianyida.com/gtsp/platformResource/wop/doc-center` | 文档中心基址 |
+| `WOP_KEYS_DIR` | `./keys` | 私钥落盘目录（0600 文件） |
+| `WOP_INDEX_CACHE_TTL` | `300` | `llms.txt` 索引进程内缓存秒数（`0` 关闭） |
+| `WOP_HTTP_TIMEOUT` | `15` | HTTP 超时秒数 |
+
+## 安全纪律
+
+- **私钥只落盘不回显**：`wop_gen_key_pair` 返回值不含任何私钥材料；私钥以 0600 权限独占创建于 `WOP_KEYS_DIR`。
+- **公钥即上报格式**：RSA = X.509 SPKI DER 的 Base64；SM2 = 未压缩点 `04‖X‖Y`（65 字节）的 Base64（[crypto-strategy-spec](https://github.com/wop-platform/wop-specs) §3.4，D10/D12）。
+- **契约自检**：每次生成后经 [wop-python-sdk](https://github.com/wop-platform/wop-python-sdk) 官方加载器回读（含 SM2 曲线校验），编码不合约即报错。
+- `keys/` 目录已入 `.gitignore`，**严禁**将私钥文件提交入库或粘贴进对话。
+
+## 算法说明（与 spec 的差异）
+
+本工具密钥生成支持 `RSA2048` / `SM2`。`crypto-strategy-spec` v0.4 草案的 securityReq
+国际族档位为 RSA3072/RSA4096；平台实际接受的 RSA 档位以商户中心审核为准。
+国密族与国际族禁止跨族组合。
+
+## 开发
+
+```bash
+uv sync                          # 安装依赖（含 dev 组）
+uv run pytest --cov=wop_mcp --cov-fail-under=95   # 测试 + 覆盖率门禁
+npm i -g lefthook && lefthook install             # 激活 git 钩子（commitlint + 覆盖率门禁）
+```
+
+- 提交信息遵循 [Conventional Commits](https://www.conventionalcommits.org/zh-CN/)（commitlint 校验）
+- CI：GitHub Actions，Python 3.10–3.13 矩阵，覆盖率红线 95%
+
+## 许可证
+
+[MIT](LICENSE) © 2026 wop-platform

wop_mcp-0.1.0/README.md

@@ -0,0 +1,125 @@
+# wop-mcp
+
+**万联易达开放平台（WOP）MCP Server —— 让 AI 助手安全、正确地完成 WOP 对接**
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![MCP](https://img.shields.io/badge/MCP-Server-orange.svg)](https://modelcontextprotocol.io/)
+[![Coverage ≥95%](https://img.shields.io/badge/coverage-%E2%89%A595%25-brightgreen)]()
+
+## 简介
+
+`wop-mcp` 是万联易达开放平台（WOP）的 [Model Context Protocol](https://modelcontextprotocol.io/) Server，
+帮助开发者通过 AI 助手（Claude Desktop、Cursor、Claude Code 等）完成 WOP 对接：
+
+- 📚 **文档获取**：接入指南、API 索引、接口详情（自动穿透文档 URL 的时间戳后缀）
+- 🔐 **密钥对生成**：RSA2048 / SM2，公钥按分发契约编码返回，可直接上报平台
+- 🛡️ **安全纪律**：私钥只写入本地 0600 文件，**永不回显进 AI 对话**（对齐 [wop-skills](https://github.com/wop-platform/wop-skills) SECURITY 纪律）
+- 🔌 **即插即用**：stdio transport，`uvx wop-mcp`（PyPI 发布后）一行接入
+
+## 工具总览
+
+| 工具 | 说明 |
+|---|---|
+| `wop_overview()` | 接入指南（三步流程、securityReq 组合、公钥编码、SDK 列表）+ 实时 `llms.txt` API 索引 |
+| `wop_api_detail(api)` | API 详情；入参支持 API 路径（如 `/staffing/open/v1/invoice/apply`，可带 POST 前缀、支持省略业务域前缀的后缀匹配）、接口中文名（如 `转账提交`）、完整 `.md` URL |
+| `wop_link_detail(url)` | 文档中心任意子页 / 外链内容（相对路径自动拼接基址，如 `llms-full.txt`） |
+| `wop_gen_key_pair(algorithm)` | `RSA2048`（别名 `RSA`）或 `SM2`；返回 `publicKey`（契约编码）+ `privateKeyFile`（0600 路径） |
+
+## 快速开始
+
+### 方式一：uvx 直接运行（PyPI 发布后）
+
+```bash
+uvx wop-mcp
+```
+
+### 方式二：源码运行
+
+```bash
+git clone https://github.com/wop-platform/wop-mcp.git
+cd wop-mcp
+uv sync
+uv run wop-mcp
+```
+
+## 在 AI 工具中配置
+
+### Cursor
+
+```json
+{
+  "mcpServers": {
+    "wop-mcp": {
+      "command": "uvx",
+      "args": ["wop-mcp"],
+      "timeout": 600,
+      "autoApprove": ["wop_overview", "wop_api_detail", "wop_link_detail"]
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+macOS：`~/Library/Application Support/Claude/claude_desktop_config.json`
+Windows：`%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "wop-mcp": {
+      "command": "uvx",
+      "args": ["wop-mcp"]
+    }
+  }
+}
+```
+
+源码方式将 `command`/`args` 替换为：
+
+```json
+{
+  "command": "uv",
+  "args": ["--directory", "/path/to/wop-mcp", "run", "wop-mcp"]
+}
+```
+
+> `wop_gen_key_pair` 写本地私钥文件，建议保留人工确认（未列入 autoApprove）。
+
+## 环境变量
+
+| 变量 | 默认值 | 说明 |
+|---|---|---|
+| `WOP_DOC_BASE_URL` | `https://assets.wanlianyida.com/gtsp/platformResource/wop/doc-center` | 文档中心基址 |
+| `WOP_KEYS_DIR` | `./keys` | 私钥落盘目录（0600 文件） |
+| `WOP_INDEX_CACHE_TTL` | `300` | `llms.txt` 索引进程内缓存秒数（`0` 关闭） |
+| `WOP_HTTP_TIMEOUT` | `15` | HTTP 超时秒数 |
+
+## 安全纪律
+
+- **私钥只落盘不回显**：`wop_gen_key_pair` 返回值不含任何私钥材料；私钥以 0600 权限独占创建于 `WOP_KEYS_DIR`。
+- **公钥即上报格式**：RSA = X.509 SPKI DER 的 Base64；SM2 = 未压缩点 `04‖X‖Y`（65 字节）的 Base64（[crypto-strategy-spec](https://github.com/wop-platform/wop-specs) §3.4，D10/D12）。
+- **契约自检**：每次生成后经 [wop-python-sdk](https://github.com/wop-platform/wop-python-sdk) 官方加载器回读（含 SM2 曲线校验），编码不合约即报错。
+- `keys/` 目录已入 `.gitignore`，**严禁**将私钥文件提交入库或粘贴进对话。
+
+## 算法说明（与 spec 的差异）
+
+本工具密钥生成支持 `RSA2048` / `SM2`。`crypto-strategy-spec` v0.4 草案的 securityReq
+国际族档位为 RSA3072/RSA4096；平台实际接受的 RSA 档位以商户中心审核为准。
+国密族与国际族禁止跨族组合。
+
+## 开发
+
+```bash
+uv sync                          # 安装依赖（含 dev 组）
+uv run pytest --cov=wop_mcp --cov-fail-under=95   # 测试 + 覆盖率门禁
+npm i -g lefthook && lefthook install             # 激活 git 钩子（commitlint + 覆盖率门禁）
+```
+
+- 提交信息遵循 [Conventional Commits](https://www.conventionalcommits.org/zh-CN/)（commitlint 校验）
+- CI：GitHub Actions，Python 3.10–3.13 矩阵，覆盖率红线 95%
+
+## 许可证
+
+[MIT](LICENSE) © 2026 wop-platform

wop_mcp-0.1.0/commitlint.config.js

@@ -0,0 +1,23 @@
+/**
+ * commitlint 配置 —— 对齐 wop-skills 治理标准与 Conventional Commits
+ * 规则等级：2 = error（阻断）| 1 = warn（警告不阻断）| 0 = 关闭
+ */
+module.exports = {
+  extends: ['@commitlint/config-conventional'],
+  rules: {
+    'type-enum': [
+      2,
+      'always',
+      ['feat', 'fix', 'docs', 'style', 'refactor', 'perf', 'test', 'chore', 'revert'],
+    ],
+    'scope-enum': [
+      1,
+      'always',
+      ['api', 'docs', 'keypair', 'mcp', 'http', 'crypto', 'ci', 'build', 'test', 'security', 'deps'],
+    ],
+    'subject-max-length': [2, 'always', 50],
+    'header-max-length': [2, 'always', 72],
+    // 中文 subject 不适用英文大小写规则
+    'subject-case': [0],
+  },
+};

wop_mcp-0.1.0/lefthook.yml

@@ -0,0 +1,11 @@
+# 治理对齐 wop-skills：commit-msg 走 commitlint；pre-push 跑覆盖率门禁（≥95% 红线）
+# 激活：npm i -g lefthook && lefthook install
+commit-msg:
+  commands:
+    commitlint:
+      run: npx --yes @commitlint/cli@19 --edit {1}
+
+pre-push:
+  commands:
+    coverage-gate:
+      run: uv run pytest --cov=wop_mcp --cov-fail-under=95 -q

wop_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,59 @@
+[project]
+name = "wop-mcp"
+version = "0.1.0"
+description = "万联易达开放平台（WOP）MCP Server —— 文档获取与密钥对生成"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "wop-platform" }]
+keywords = ["wop", "mcp", "wanlianyida", "open-platform", "sm2", "rsa"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Security :: Cryptography",
+]
+dependencies = [
+    "mcp>=2.0",
+    "cryptography>=41",
+    "gmssl>=3.2.2",
+    "wop-python-sdk>=0.1.7",
+]
+
+[project.urls]
+Homepage = "https://github.com/wop-platform/wop-mcp"
+Repository = "https://github.com/wop-platform/wop-mcp"
+Changelog = "https://github.com/wop-platform/wop-mcp/releases"
+Issues = "https://github.com/wop-platform/wop-mcp/issues"
+
+[project.scripts]
+wop-mcp = "wop_mcp.main:main"
+
+[dependency-groups]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/wop_mcp"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"
+
+[tool.coverage.run]
+source = ["wop_mcp"]
+
+[tool.coverage.report]
+fail_under = 95
+show_missing = true

wop_mcp-0.1.0/src/wop_mcp/__init__.py

@@ -0,0 +1,4 @@
+# -*- coding: utf-8 -*-
+"""wop-mcp：万联易达开放平台（WOP）MCP Server。"""
+
+__version__ = "0.1.0"

wop_mcp-0.1.0/src/wop_mcp/config.py

@@ -0,0 +1,48 @@
+# -*- coding: utf-8 -*-
+"""运行配置：环境变量可覆盖，默认值指向生产文档中心 CDN。
+
+环境变量清单：
+- WOP_DOC_BASE_URL       文档中心基址（默认 assets.wanlianyida.com …/doc-center）
+- WOP_KEYS_DIR           密钥对私钥落盘目录（默认 ./keys）
+- WOP_INDEX_CACHE_TTL    llms.txt 索引进程内缓存秒数（默认 300；<=0 表示不缓存）
+- WOP_HTTP_TIMEOUT       HTTP 超时秒数（默认 15）
+"""
+from __future__ import annotations
+
+import os
+from pathlib import Path
+
+DEFAULT_DOC_BASE_URL = (
+    "https://assets.wanlianyida.com/gtsp/platformResource/wop/doc-center"
+)
+DEFAULT_KEYS_DIR = "./keys"
+DEFAULT_INDEX_CACHE_TTL_SECONDS = 300.0
+DEFAULT_HTTP_TIMEOUT_SECONDS = 15.0
+
+
+def doc_base_url() -> str:
+    """文档中心基址（去尾部斜杠）。"""
+    return os.environ.get("WOP_DOC_BASE_URL", DEFAULT_DOC_BASE_URL).rstrip("/")
+
+
+def keys_dir() -> Path:
+    """私钥落盘目录。"""
+    return Path(os.environ.get("WOP_KEYS_DIR", DEFAULT_KEYS_DIR))
+
+
+def index_cache_ttl_seconds() -> float:
+    """llms.txt 索引缓存 TTL（秒）。"""
+    raw = os.environ.get("WOP_INDEX_CACHE_TTL", "")
+    try:
+        return float(raw)
+    except ValueError:
+        return DEFAULT_INDEX_CACHE_TTL_SECONDS
+
+
+def http_timeout_seconds() -> float:
+    """HTTP 下载超时（秒）。"""
+    raw = os.environ.get("WOP_HTTP_TIMEOUT", "")
+    try:
+        return float(raw)
+    except ValueError:
+        return DEFAULT_HTTP_TIMEOUT_SECONDS